Symfony5+SendGrid发送含特殊字符邮箱报501语法错误求助

问题原因 #

你遇到的501 Recipient syntax error错误，是因为带ñ、重音符号的邮箱属于国际化域名邮箱（IDN），SMTP协议本身仅支持ASCII字符，直接发送Unicode格式的邮箱地址会被SMTP服务器判定为语法错误。需要将邮箱的域名部分转换为ASCII兼容的Punycode编码后再发送。

解决步骤 #

1. 确保PHP环境支持IDN转换 #

确认你的PHP环境已启用intl扩展（大部分服务器默认启用），该扩展提供的idn_to_ascii函数可用于将国际化域名转换为Punycode。

2. 添加邮箱地址转换逻辑 #

在邮件发送类中添加辅助函数，专门处理邮箱地址的IDN转换：

private function convertIdnEmail(string $email): string
{
    $parts = explode('@', $email, 2);
    if (count($parts) !== 2) {
        return $email; // 非法邮箱格式，直接返回原地址
    }
    
    [$localPart, $domain] = $parts;
    // 将国际化域名转换为Punycode
    $punycodeDomain = idn_to_ascii($domain, IDNA_DEFAULT, INTL_IDNA_VARIANT_UTS46);
    
    return sprintf('%s@%s', $localPart, $punycodeDomain);
}

3. 修改邮件发送代码 #

构建邮件对象时，对所有收件人地址（包括to、cc、bcc）应用转换逻辑：

public function sendMail(): void
{
    $email = (new Email())
        ->from(new Address($this->from_email, $this->from_name))
        ->to($this->convertIdnEmail($this->to_email))
        ->subject($this->subject)
        ->html($this->html);

    if (!empty($this->cc_email)) {
        $email->cc($this->convertIdnEmail($this->cc_email));
    }
    if (!empty($this->bcc_email)) {
        $email->bcc($this->convertIdnEmail($this->bcc_email));
    }
    if (!empty($this->file_path)) {
        $email->attachPart(new DataPart(fopen($this->file_path, 'r'), $this->file_name));
    }

    $this->mailer->send($email);
}

4. 替代方案（使用Symfony Intl组件） #

如果项目依赖symfony/intl组件，可使用它的Idn类处理转换，兼容性更好：

use Symfony\Component\Intl\Idn\Idn;

private function convertIdnEmail(string $email): string
{
    $parts = explode('@', $email, 2);
    if (count($parts) !== 2) {
        return $email;
    }
    
    [$localPart, $domain] = $parts;
    $punycodeDomain = Idn::toAscii($domain);
    
    return sprintf('%s@%s', $localPart, $punycodeDomain);
}

验证 #

转换后，带特殊字符的邮箱（如usuario@ejemploñ.com）会被转为usuario@xn--ejemplo-pta.com，SendGrid的SMTP服务器可以正常识别该格式，不会再返回501错误。

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