Ruby应用无法连接IMAP服务器993端口问题排查与解决

问题描述 #

在Rails 7.0.4（Ruby 2.7.3）环境中，使用Net::IMAP连接邮件服务器的993端口（隐式SSL/TLS）时出现连接重置错误：

Loading dev environment (Rails 7.0.4)
irb(main):001:0> @connection = Net::IMAP.new('mail.test.com.test', 993, true)

Traceback (most recent call last):
        2: from (irb):1
        1: from (irb):1:in `new'
Errno::ECONNRESET (Connection reset by peer - SSL_connect)

通过OpenSSL测试993端口时，无法完成SSL握手：

openssl s_client -connect mail.test.com.test:993 

CONNECTED(00000003)
write:errno=104
---
no peer certificate available
---
No client certificate CA names sent
---
SSL handshake has read 0 bytes and written 319 bytes
Verification: OK
---
New, (NONE), Cipher is (NONE)
Secure Renegotiation IS NOT supported
No ALPN negotiated
Early data was not sent
Verify return code: 0 (ok)
---

但使用143端口+STARTTLS的方式可以正常建立加密连接：

openssl s_client -connect mail.test.com.test:143 -starttls imap -brief

CONNECTION ESTABLISHED
Protocol version: TLSv1.2
Ciphersuite: <suite>
Peer certificate: CN = mail.test.com.test
Hash used: SHA256
Signature type: RSA
Verification: OK
Server Temp Key: <key>, P-384, 384 bits
. OK CAPABILITY completed.

原因分析 #

• 邮件服务器的993端口（IMAPS服务）未正确配置或未启用：从OpenSSL测试结果来看，连接993端口后没有收到服务器返回的SSL证书，握手直接被重置，说明服务器在993端口可能没有监听IMAPS服务，或者服务的SSL证书配置存在错误（比如证书未部署、证书路径配置错误）。
• 两种加密连接方式的差异：*隐式SSL/TLS（993端口）要求连接建立时立即发起SSL握手，而显式STARTTLS（143端口）*是先建立明文IMAP连接，再通过STARTTLS命令升级为加密连接。当前服务器仅配置了143端口的STARTTLS支持，未启用993端口的IMAPS服务。

解决方法 #

方法1：改用143端口+STARTTLS连接 #

在Ruby代码中，先建立明文IMAP连接，再手动启动TLS加密：

# 建立明文连接（第三个参数设为false，表示不立即使用SSL）
@connection = Net::IMAP.new('mail.test.com.test', 143, false)
# 启动TLS加密
@connection.start_tls
# 执行登录操作
@connection.login('your_username', 'your_password')

方法2：修复服务器端993端口配置 #

如果必须使用993端口，需要联系邮件服务器管理员：

• 确认993端口的IMAPS服务已启动并监听
• 检查IMAPS服务的SSL证书配置，确保证书有效且部署路径正确
• 验证服务器防火墙是否允许993端口的入站连接

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