更换PHPMailer使用的邮箱地址是否需要调整DKIM密钥及相关配置

更换发件邮箱是否需要修改DKIM密钥/关联域名配置 #

分两种场景判断：

• 新旧发件邮箱属于同一个域名：比如之前用service@abc.com，更换为notify@abc.com，且此前已经为该域名配置过生效的DKIM、SPF等解析记录，无需修改域名侧的关联配置。
• 新旧发件邮箱属于不同域名：比如从service@abc.com更换为service@xyz.com，必须同步调整域名配置：
  • 新域名的DNS记录中添加对应DKIM公钥记录
  • 调整新域名的SPF记录，将当前发件服务器IP/所用发件服务加入允许发送列表
  • 若配置了DMARC记录，需确认新域名的DMARC策略适配当前发件场景

更换邮箱后发送失败需排查的配置项 #

基础配置排查 #

• 核对PHPMailer核心发件参数是否修改正确：
  • From属性是否已更新为新的发件邮箱地址
  • 若使用第三方SMTP服务，确认SMTP服务器地址、端口、Username（通常为完整发件邮箱地址）、Password（部分服务商要求填专用授权码而非邮箱登录密码）匹配新邮箱的要求
  • 确认新邮箱的SMTP发送权限已开启，部分邮箱服务商默认关闭SMTP功能需手动开启
  • 排查是否触发了新邮箱的发信频率、单次发件人数等限制规则

DKIM相关配置排查 #

• 若你在PHPMailer代码中自主配置DKIM签名，需同步更新以下参数：
  • DKIM_domain：需和新发件邮箱的域名完全一致，比如新邮箱为xxx@xyz.com，该参数填xyz.com
  • DKIM_selector：需和新域名DNS中配置的DKIM选择器完全匹配，比如DNS记录为default._domainkey.xyz.com，选择器参数填default
  • DKIM_private：替换为和新域名DKIM公钥配对的私钥文件路径/私钥内容，旧域名私钥和新域名公钥不匹配会直接导致DKIM验证失败，触发邮件拒收
  • DKIM_passphrase：若新DKIM私钥设置了访问密码，同步更新为对应密码
• 若你使用SMTP服务商自带的DKIM签名功能，无需在PHPMailer中配置任何DKIM参数，否则会出现重复签名导致验证失败的问题，只需确认新域名在服务商侧的DKIM配置已生效即可

内容的提问来源于stack exchange，提问作者Coco