You need to enable JavaScript to run this app. EC2上Amazon SES发信脚本命令行正常,POST请求调用触发500错误
优惠活动
大模型
产品
解决方案
定价
更多

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状态码,不暴露具体错误原因:

  • 临时在脚本最开头加入两行代码打开错误显示:
    ini_set('display_errors', 1);
    error_reporting(E_ALL);
    
    重新发起POST请求,即可在返回结果中看到具体的致命错误信息
  • 同时查看对应日志文件交叉验证: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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.10 16:45:04