如何修复Codeigniter中使用Gmail SMTP发送邮件时的550 HELO名称错误

错误原因 #

该550错误是因为SMTP握手阶段的HELO/EHLO命令提供了无效主机名（你代码中设置了$config['helo'] = NULL），Gmail服务器会严格遵循RFC2821规范验证HELO字段，不符合要求则直接拒绝请求。

修复步骤 #

• 配置有效的HELO主机名：将$config['helo']设置为你的服务器域名（如yourdomain.com）或合法主机标识，不可留空或设为NULL。
• 修正Gmail SMTP专属配置：
  • smtp_host固定设为smtp.gmail.com
  • 端口选择465（搭配SSL加密）或587（搭配TLS加密）
  • 添加$config['smtp_crypto'] = 'ssl';（对应465端口）或'tls'（对应587端口）
  • 若Gmail账号开启两步验证，必须使用应用专用密码替代普通密码；未开启的话，需在谷歌账号设置中允许“不太安全的应用访问”（不推荐，建议开启2FA并使用专用密码）
• 清理冗余配置：使用SMTP协议时，mailpath是sendmail路径配置，无实际作用，直接删除该配置项。
• 补充完整邮件发送逻辑：原代码仅完成配置初始化，缺少发件人、收件人设置及发送动作，必须补充。

修改后的完整代码示例 #

$config = array();
$config['wordwrap'] = TRUE;
$config['mailtype'] = 'html';
$config['priority'] = 1;
$config['crlf'] = "\r\n";
$config['newline'] = "\r\n"; // 必须设置，避免Gmail格式验证失败
$config['helo'] = 'yourdomain.com'; // 替换为你的服务器域名或合法主机名
$config['protocol'] = 'smtp'; 
$config['smtp_host'] = 'smtp.gmail.com'; 
$config['smtp_user'] = 'your-gmail-address@gmail.com';
$config['smtp_pass'] = 'your-app-specific-password'; // 开启2FA用专用密码，否则用普通密码
$config['smtp_port'] = 465; 
$config['smtp_crypto'] = 'ssl'; // 对应465端口，用587则改为'tls'
$config['smtp_auth'] = TRUE;

$this->load->library('email');
$this->email->initialize($config);

// 设置邮件核心信息
$this->email->from('your-gmail-address@gmail.com', '你的发件人名称');
$this->email->to('recipient@example.com');
$this->email->subject($email_data["mail_title"]);
$this->email->message($email_data["mail_body"]);

// 执行发送并调试
if (!$this->email->send()) {
    echo $this->email->print_debugger(); // 上线后可移除调试代码
} else {
    echo '邮件发送成功';
}

额外注意事项 #

• 确保服务器防火墙允许出站连接到Gmail的SMTP端口（465或587）
• 使用TLS（587端口）时，服务器需支持TLS 1.2及以上版本
• 谷歌账号的应用专用密码需在账号安全设置中生成，仅对开启2FA的账号可用

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