Opencart 3.0站点联系我们表单提交后无法发送邮件排查求助

1. 前端提交环节校验 #

• 确认表单提交无前端拦截：你提供的表单提交按钮绑定了gtag_report_conversion事件，先在浏览器控制台测试点击提交后该函数是否返回false导致表单终止提交；正常逻辑下提交后应跳转到/index.php?route=information/contact/success成功页，如果停留在原页且无表单报错，优先排查前端JS拦截问题。
• 校验表单参数是否正常传递：按F12打开浏览器网络面板，提交表单后查看对应POST请求的FormData参数，确认name、email、enquiry以及验证码（如果开启）参数是否完整传递，无缺失或者格式错误。

2. 后端控制器逻辑校验 #

• 定位对应控制器文件：Opencart默认联系表单的控制器路径是catalog/controller/information/contact.php，找到index()方法，先校验参数校验逻辑是否会命中无报错的拦截（比如隐藏的反垃圾规则、IP拦截规则），是否走到了发送邮件的代码段。
• 排查扩展冲突：如果安装过第三方表单扩展、邮件增强扩展、安全防护扩展，先临时关闭这些扩展后测试发信是否正常，排除扩展兼容问题。
• 可以在邮件发送逻辑前加临时日志输出，比如把接收到的表单参数、是否触发发送条件写入storage/logs下的日志文件，确认请求确实走到了发信逻辑。

3. 系统邮件配置校验 #

• 进入Opencart后台，路径为「系统设置-编辑门店-邮件」标签页，确认邮件发送引擎配置正确：
  • 如果用的是SMTP模式，校验SMTP地址、端口、账号、密码、加密方式（SSL/TLS）是否和邮件服务商要求一致，注意部分云服务商默认封禁25端口，需要改用465/587端口。
  • 如果用的是PHP mail()函数，确认服务器php.ini配置里的sendmail路径正确，对应发信服务（sendmail/postfix）处于运行状态。
• 可以单独写个测试脚本调用Opencart的邮件类发信，排除配置错误问题。

4. 发信链路排查 #

• 查看服务器邮件发送日志：如果是Linux服务器，postfix日志默认在/var/log/maillog，sendmail日志在/var/log/mail.log，查看提交表单时是否有发信请求，是否有退信、连接SMTP失败、认证失败等报错信息。
• 校验发件人域名的SPF、DKIM记录是否配置正确，避免邮件被服务商判定为垃圾邮件直接拒收。

5. 收件端校验 #

• 检查收件邮箱的垃圾箱、广告邮件文件夹，确认邮件是否被归类到了非收件箱目录。
• 如果是企业域名邮箱，检查域名邮箱的后台拦截规则、黑白名单设置，确认发件人地址没有被拦截。

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