CMS对接SMTP邮件，网站邮件通知配置排错
网站注册验证、密码找回、订单提醒发不出去，多数情况不是CMS本身坏了，而是SMTP参数或服务器出站限制没配对。
本文按零基础可照做的顺序，先确认准备条件，再填写SMTP参数，最后用测试邮件验证，并给出连接超时、认证失败、被当垃圾邮件三类高频问题的定位方法。
动手前先确认三件事
CMS对接SMTP邮件，本质是让网站程序通过第三方邮件服务商的发信服务器把通知投递出去。
开始配置前先确认：
- 发信账号已开通SMTP服务：常见服务商需要在邮箱设置里单独开启SMTP，并生成授权码或专用密码，不是直接填登录密码。
- 服务器允许出站连接：云服务器安全组和本机防火墙要放行SMTP端口，否则会一直连接超时。
- CMS后台有邮件设置入口：一般在后台的“系统设置”“邮件设置”或“通知设置”里，找到SMTP相关字段。
准备一个能正常收信的测试邮箱，建议用与发信域名不同的邮箱，方便判断是否被拦截。
SMTP参数怎么填
进入CMS后台邮件设置页面，按下面字段逐项填写：
- SMTP服务器地址：如
smtp.example.com，以邮箱服务商官方文档为准。 - SMTP端口：常见
465（SSL）或587（TLS），部分服务商也支持25。 - 加密方式：端口465选SSL，端口587选TLS/STARTTLS，两者要对应。
- 发信邮箱：完整的邮箱地址，通常要和SMTP账号一致。
- SMTP密码/授权码：填服务商生成的授权码，不是网页登录密码。
- 发件人名称：显示给收件人的名字，建议用站点名。
宝塔面板用户如果CMS装在宝塔环境，还要确认PHP的 openssl 扩展已开启，否则SSL加密连接会失败。
可在“软件商店 → PHP → 设置 → 扩展”里检查。
用测试邮件确认链路通不通
参数保存后，后台通常有“发送测试邮件”按钮。
填一个测试邮箱，点击发送，观察提示：
- 提示发送成功：去收件箱和垃圾箱都查一下，确认是否收到。
- 提示失败但信息模糊：先看CMS日志或宝塔的PHP错误日志，路径一般在
/www/wwwlogs/下。 - 完全无反应：检查服务器能否连通SMTP服务器，命令行执行
telnet smtp.example.com 465，能连上说明网络通。
只有在测试邮件能正常收到后，再开启注册验证、订单通知等自动发信功能，避免把问题混在一起排查。
三类高频报错怎么定位
连接超时或无法连接：多半是端口没放行。
检查云服务器安全组是否放行465/587，本机防火墙执行 firewall-cmd --list-ports 查看。
也可能是服务商封了25端口，换465或587再试。
认证失败：提示 Authentication failed 或 535，通常是密码填成了登录密码，应改用授权码；
或者发信邮箱与SMTP账号不一致。
部分服务商要求发件人地址必须是已验证域名下的邮箱。
能发但进垃圾箱：检查是否配置了SPF、DKIM、DMARC记录，这些在域名DNS里设置，缺了容易被判为垃圾邮件。
发件人名称和正文含大量链接也会提高拦截概率。
配置完成后要做的验证
测试邮件成功后，别急着结束，按下面清单复查一遍：
- 触发一次真实的注册验证或密码找回，确认收件人真能收到。
- 查看CMS发信日志，确认没有堆积的失败记录。
- 换不同邮箱服务商（如QQ邮箱、Gmail）各测一次，判断是否被单一服务商拦截。
- 记录当前SMTP参数，方便以后迁移服务器时快速恢复。
如果换服务器或改域名后邮件又发不出，优先复查发信域名解析和授权码是否过期，这两处最容易在迁移后失效。
常见疑问
必须用企业邮箱吗？ 不是必须，但用个人邮箱发信量稍大就可能被限制，正式站点建议用支持SMTP的企业邮箱或邮件推送服务。
端口465和587选哪个？ 两者都可用，关键是加密方式要对应。
465配SSL，587配TLS，填错组合会直接连接失败。
测试成功但用户收不到怎么办？ 先让对方查垃圾箱，再检查发信域名是否配置SPF记录，多数是进了垃圾邮件而非没发出。
CMS对接SMTP邮件并不复杂，难的是把网络、认证、反垃圾三块分开排查。
按本文顺序先通链路、再验参数、最后查域名解析，大部分网站邮件通知问题都能定位到具体环节。
