CakePHP 3生产服务器邮件发送失败：Network is unreachable

看起来你在把代码从测试环境部署到生产服务器后，遇到了邮件发送失败的问题，报错提示Network is unreachable。我结合你提供的报错信息和app.php配置，整理了几个可能的问题点和排查方向：

首先还原你的报错和配置信息：

报错信息：

{ "message": "Network is unreachable", "url": "/api/users/emailSheets", "code": 500, "file": "domainname.com/vendor/cakephp/cakephp/src/Network/Socket.php", "line": 179 }

app.php中的邮件传输配置：

'EmailTransport' => [ 
    'default' => [ 
        'className' => 'Mail', 
        // The following keys are used in SMTP transports 
        'host' => 'localhost', 
        'port' => 25, 
        'timeout' => 30, 
        'username' => 'user', 
        'password' => 'secret', 
        'client' => null, 
        'tls' => null, 
        'url' => env('EMAIL_TRANSPORT_DEFAULT_URL', null), 
    ], 
    'gmail'=> [ 
        'host' => 'ssl://smtp.gmail.com', 
        'port' => 465, 
        'username' => 'my@gmail.com', //your gmail address 
        'password' => '123453', //your gmail password 
        'className' => 'Smtp', 
        'log' => true, 
        'context' => [ 
            'ssl' => [ 
                'verify_peer' => false, 
                'verify_peer_name' => false, 
                'allow_self_signed' => true 
            ] 
        ] 
    ], 
]

可能的问题根源 #

这个报错本质是应用无法建立到邮件服务器的网络连接，具体要分你实际使用的是哪个传输配置来分析：

1. 如果你的应用使用的是default传输配置 #

• 本地邮件服务未安装/未启动：className设为Mail时，CakePHP会依赖服务器本地的邮件程序（比如Sendmail、Postfix）。如果生产服务器上没装这类服务，或者服务没启动，就会出现网络不可达的错误。
• 端口/权限被拦截：即使装了本地邮件服务，生产服务器的防火墙（比如UFW、Firewalld）或者SELinux可能限制了PHP进程访问本地25端口，导致连接失败。
• 配置冗余冲突：default配置里同时写了Mail类和SMTP相关的host/port参数——Mail类其实不需要这些SMTP参数，它是调用系统本地程序发送邮件；如果要通过SMTP连接本地服务，应该把className改成Smtp。

2. 如果你的应用使用的是gmail传输配置 #

• 生产服务器无外部网络权限：很多生产环境会限制服务器的出站流量，尤其是465、587这类邮件端口。你需要确认服务器能否访问smtp.gmail.com，比如在终端执行telnet smtp.gmail.com 465或者curl -v smtp://smtp.gmail.com:465测试连通性。
• Gmail账号配置问题（次要排查）：虽然报错是网络问题，但如果服务器能联网，也要确认你的Gmail账号是否开启了App Password（如果开启了两步验证，普通密码会失效），不过这个通常会报认证错误，而非网络不可达。

快速排查步骤 #

1. 确认实际使用的传输配置：先检查你代码中发送邮件的逻辑，看是用了默认的default传输，还是指定了gmail传输。
2. 针对default配置的排查：
   • 执行systemctl status postfix（或对应邮件服务）查看服务是否运行；
   • 在服务器终端手动用sendmail test@example.com发送测试邮件，验证本地邮件服务是否正常；
   • 检查防火墙规则：ufw status或firewall-cmd --list-all，确认本地25端口的访问权限。
3. 针对gmail配置的排查：
   • 在服务器终端测试端口连通性：telnet smtp.gmail.com 465，如果无法连接，联系服务器管理员开放出站465端口；
   • 确认Gmail账号的App Password设置（若开启2FA）。

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