You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

使用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权限,否则会返回认证失败。
  • 发件人地址校验
    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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.09.30 21:06:01