Qt SMTP SSL连接失败：仅开发机可用，其他设备无法连接求助

架构老林

2026-7-18

问题描述

我用一款Qt的SMTP客户端（v2.0版本）开发了邮件发送应用，在开发PC上运行完全正常，但在其他设备上始终出现连接失败的错误，连登录步骤都进不去。我已经使用了邮箱的应用密码，分别测试了mail.ru和gmail.com账户，结果都是仅开发PC可用，其他设备无法运行。

相关代码如下：

smtp.connectToHost();
if (!smtp.waitForReadyConnected())   {
    writeLog("Connection Failed");
    return;
}
smtp.login(m_login, m_password);
if (!smtp.waitForAuthenticated())    {
    writeLog("Authentification Failed");
    return;
}
smtp.sendMail(message);
if (!smtp.waitForMailSent())    {
    writeLog("Mail sending failed");
    return;
} else {
    writeLog("The email was succesfully sent.");
}
smtp.quit();

请问是否需要在目标PC上配置SSL相关内容才能让应用正常工作？

解决方案分析

大概率和SSL相关配置有关，以下是具体原因及解决办法：

目标设备缺失SSL运行库
开发PC因安装Qt开发环境或其他依赖SSL的软件，已预装OpenSSL运行库（如libssl-*.dll、libcrypto-*.dll），但目标设备通常没有这些文件。Qt网络模块依赖OpenSSL处理SSL/TLS连接，而gmail、mail.ru这类服务商强制要求加密连接，缺少库文件会直接导致连接失败。
解决：将与Qt编译架构（32位/64位）匹配的OpenSSL运行库，打包到应用程序目录（和exe文件同目录）。
未明确指定SSL连接方式
代码中直接调用connectToHost()，未指定SSL端口和加密方式。多数邮箱服务商的SMTP SSL端口为465（gmail、mail.ru均默认使用），若客户端默认使用非加密的25端口，目标设备的网络环境可能拦截明文流量，或服务商直接拒绝非加密连接。
解决：修改代码，明确指定SSL加密连接及对应端口：
```
// Gmail配置示例
smtp.connectToHostEncrypted("smtp.gmail.com", 465);
// Mail.ru配置示例
// smtp.connectToHostEncrypted("smtp.mail.ru", 465);
```
目标设备SSL证书不完整
开发PC的系统信任根证书库完整，但目标设备可能缺少对应邮箱服务商的SSL根证书，导致SSL握手失败（这种情况通常会有证书错误日志，而非直接连接失败，但仍需排查）。
解决：可将服务商的根证书打包到应用中，在代码里指定加载该证书；或引导用户更新目标设备的系统根证书库。
防火墙/安全软件拦截
目标设备的防火墙或杀毒软件可能拦截了应用的出站SMTP请求（端口465或587）。可临时关闭防火墙测试，若能正常连接，将应用添加到防火墙允许列表即可。

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