使用CI3框架通过Sendgrid SMTP发送邮件无响应、投递失败
问题排查步骤
首先你需要先获取具体的错误信息,才能定位根因,在你的$bool=$this->email->send();代码后追加调试代码:
if (!$bool) { // 打印完整的邮件发送错误日志 echo $this->email->print_debugger(); exit; }
以下是对应场景的高频问题排查点:
- Sendgrid SMTP配置错误修正
这是最常见的错误原因,有4个配置项需要修正:- SMTP用户名错误:Sendgrid官方要求SMTP验证的用户名固定为字符串
apikey,不是你创建API key时自定义的名称。 - 缺少TLS加密配置:587端口对应的是TLS加密传输,CI3默认未开启SMTP加密,需要补充配置
$config['smtp_crypto'] = 'tls'。 - 配置参数类型错误:
smtp_port应为整数类型,不要加引号;smtp_keepalive应为布尔值,直接写TRUE不要用字符串包裹。 - API密钥权限校验:你使用的Sendgrid API Key必须开启
Mail Send权限,否则会返回认证失败。
- SMTP用户名错误:Sendgrid官方要求SMTP验证的用户名固定为字符串
- 发件人地址校验
Sendgrid不允许使用未验证的发件人地址发信,你当前填写的test@test.com必须先在Sendgrid后台完成单发件人验证,或者发件域名已经完成SPF/DKIM/DMARC解析验证,否则发信请求会被直接拦截。 - 内容生成逻辑排查
你使用eval()拼接主题和邮件内容的逻辑风险极高,只要$row['subject']或者$row['message']中包含未正确转义的双引号、PHP特殊字符,就会导致$subject或$message变量生成异常,甚至语法错误中断执行,建议替换为普通字符串替换逻辑,不要使用eval。 - 服务器网络校验
确认你的服务器没有被服务商封禁587端口,可以通过在服务器执行命令telnet smtp.sendgrid.net 587测试连通性,如果连接失败可以尝试更换Sendgrid支持的2525端口,或者联系服务商解禁端口。
修正后的参考配置
$this->load->library('email'); $config['protocol'] = 'smtp'; $config['smtp_host'] = 'smtp.sendgrid.net'; $config['smtp_user'] = 'apikey'; // 固定填写apikey,不要替换为自定义的API key名称 $config['smtp_pass'] = '你的实际Sendgrid API Key'; $config['smtp_port'] = 587; $config['smtp_crypto'] = 'tls'; $config['smtp_keepalive'] = TRUE; $config['mailtype'] = 'html'; // 如果你发送的是HTML邮件需要加这个配置,默认是纯文本 $config['charset'] = 'utf-8'; $config['newline'] = "\r\n"; // CI3 SMTP发送要求换行符为\r\n,否则可能出现兼容性问题 $this->email->initialize($config);
内容的提问来源于stack exchange,提问作者Hamza Zafeer
相关产品推荐
相关产品推荐

