初始化Discord Bot时遭遇SSL证书主机名不匹配错误求助

错误原因 #

你的Discord Bot使用SOCKS代理后出现HostnameUnverifiedException，核心原因是代理在转发Discord网关（gateway.discord.gg）的HTTPS流量时，替换了原始SSL证书，导致Java的SSL验证无法通过主机名匹配检查。加上你代码中手动开启了setVerifyHostname(true)，直接触发了这个异常。

解决方案 #

方案1：临时关闭主机名验证（快速解决，仅适用于可信代理环境） #

如果你完全信任当前使用的SOCKS代理，可以关闭WebSocket的主机名验证，绕过这个错误：
修改代码中WebSocketFactory的配置：

builder.setWebsocketFactory(new WebSocketFactory().setSSLContext(mySSLContext).setVerifyHostname(false));

注意：此操作会降低SSL连接的安全性，仅在测试环境或你能确保代理可信时使用。

方案2：将代理证书加入Java信任库（安全方案） #

如果不想关闭验证，需要让Java信任代理的SSL证书：

1. 获取代理的根证书（可通过浏览器访问代理管理页面导出，或使用抓包工具提取）
2. 使用Java自带的keytool命令将证书导入系统信任库：

keytool -import -alias proxy-cert -file /path/to/your-proxy-cert.crt -keystore $JAVA_HOME/lib/security/cacerts

默认信任库密码为changeit，导入完成后，Java会认可代理的证书，主机名验证即可正常通过。

方案3：检查代理配置 #

确认你的SOCKS代理是否为纯流量转发模式：

• 若代理启用了MITM（中间人）功能，必须处理证书信任问题；
• 若应为纯SOCKS5代理却出现此问题，检查代理是否配置错误，尝试更换代理服务。

额外说明 #

日志中的SLF4J警告并非连接失败的原因，只是缺少日志实现，可忽略或添加SLF4J的依赖（如logback-classic）来消除警告。

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