EC2上Amazon SES发信脚本命令行正常,POST请求调用触发500错误
故障场景说明
参照AWS SES官方SMTP发信配置指南,在EC2实例上完成Amazon SES的SMTP发信配置,存在明确的环境差异故障表现:
- 在EC2终端直接执行
php teste.php命令时,测试脚本可正常完成邮件发送流程 - 当通过HTTP POST请求触发该脚本执行发信时,服务统一返回500内部服务器错误,通过Chrome、Insomnia客户端发起的请求均可稳定复现该问题
- 目前尚未定位到故障根因,附带的测试脚本代码如下:
<?php use PHPMailer\PHPMailer\PHPMailer; use PHPMailer\PHPMailer\Exception; // Composer autoload.php 加载路径 require '../../../home/ec2-user/vendor/autoload.php'; $sender = 'email@email.com'; $senderName = 'Teste'; $recipient = 'email@email.com'; $usernameSmtp = '[已做安全脱敏处理]'; $passwordSmtp = '[已做安全脱敏处理]'; $host = 'email-smtp.sa-east-1.amazonaws.com'; $port = 587; $subject = 'Amazon SES test (SMTP interface accessed using PHP)'; $bodyText = "Email Test\r\nThis email was sent through the Amazon SES SMTP interface using the PHPMailer class."; $bodyHtml = '<h1>Email Test</h1> <p>This email was sent through the Amazon SES SMTP interface using the PHPMailer class.</p>'; $mail = new PHPMailer(true); try { $mail->isSMTP(); $mail->setFrom($sender, $senderName); $mail->Username = $usernameSmtp; $mail->Password = $passwordSmtp; $mail->Host = $host; $mail->Port = $port; $mail->SMTPAuth = true; $mail->SMTPSecure = 'tls'; $mail->addCustomHeader('X-SES-CONFIGURATION-SET'); $mail->addAddress($recipient); $mail->isHTML(true); $mail->Subject = $subject; $mail->Body = $bodyHtml; $mail->AltBody = $bodyText; $mail->Send(); echo "Email sent!", PHP_EOL; } catch (phpmailerException $e) { echo "An error occurred. {$e->errorMessage()}", PHP_EOL; } catch (Exception $e) { echo "Email not sent. {$mail->ErrorInfo}", PHP_EOL; }
根因定位思路与解决方案
本故障的核心差异是CLI执行环境与Web服务执行环境的配置、权限、路径解析规则完全不同,所有排查围绕两类环境的偏差展开:
1. 优先排查autoload相对路径解析错误
脚本中使用的 require '../../../home/ec2-user/vendor/autoload.php' 是基于当前工作目录解析的相对路径:
- CLI模式下,当前工作目录是你执行php命令时所在的目录,相对路径可以正常解析
- Web模式下,PHP-FPM进程的当前工作目录默认是Web站点根目录(如
/var/www/html),相对路径会解析到完全错误的位置,触发“文件不存在”的PHP致命错误,直接返回500 - 修复方法:删除相对路径拼接逻辑,改为直接写死autoload文件的绝对路径,例如
require '/home/ec2-user/vendor/autoload.php';
2. 第二优先级排查Web运行用户的读取权限问题
- CLI模式下,你是以
ec2-user身份运行PHP进程,对自身家目录下的vendor依赖文件有完整读取权限 - Web模式下,PHP进程由Web服务的运行用户(如Apache的
apache用户、Nginx配套的nginx/www-data用户)启动,默认对/home/ec2-user这类用户家目录没有读取权限,会触发“权限拒绝”的致命错误 - 排查与修复步骤
- 执行
ps aux | grep -E 'httpd|nginx|php-fpm'找到运行PHP-FPM进程的所属用户 - 验证该用户的文件读取权限:执行
sudo -u [Web运行用户名] test -r /home/ec2-user/vendor/autoload.php && echo "权限正常" || echo "权限不足" - 修复方案二选一:将vendor依赖目录移动到Web用户有读取权限的路径(如站点目录下的
vendor文件夹);或按最小权限原则调整/home/ec2-user目录的权限链,给Web用户开放必要的读取权限(禁止直接给目录设777权限)
- 执行
3. 快速定位真实报错的通用方法
默认PHP的Web运行模式会关闭错误输出,仅返回通用的500状态码,不暴露具体错误原因:
- 临时在脚本最开头加入两行代码打开错误显示:
重新发起POST请求,即可在返回结果中看到具体的致命错误信息ini_set('display_errors', 1); error_reporting(E_ALL); - 同时查看对应日志文件交叉验证:Apache站点错误日志、Nginx站点错误日志、PHP-FPM运行错误日志,常见路径为
/var/log/httpd/error_log、/var/log/nginx/error.log、/var/log/php-fpm/www-error.log
4. 其他高频排查点
- 检查PHP配置差异:CLI模式和Web模式加载的php.ini配置文件通常不是同一个,确认Web环境下是否安装了PHPMailer依赖的openssl、curl等扩展,避免类加载失败
- 排查SELinux拦截:Amazon Linux默认开启SELinux,Web用户进程可能被规则拦截读取
/home目录下的文件,执行sudo ausearch -m AVC -ts recent可查看最近的SELinux拦截记录 - 修正异常捕获逻辑:当前脚本捕获的
phpmailerException没有加命名空间前缀,真实抛出异常时会因为找不到异常类触发致命错误,应改为捕获全局命名空间下的\PHPMailer\PHPMailer\Exception
内容的提问来源于stack exchange,提问作者ronate
相关产品推荐
相关产品推荐

