Grails项目创建失败问题排查：SSL连接异常分析

问题背景

在使用Grails 5.3.6创建新项目时，开发者遇到了"SSL peer shut down incorrectly"的错误提示。这个错误表明在尝试访问Grails中央仓库时出现了SSL连接问题。

环境配置

开发者使用的是以下环境配置：

• 操作系统：Ubuntu
• JDK版本：11.0.19
• Grails版本：5.3.6
• 环境变量配置正确，包括GRAILS_HOME和JAVA_HOME

错误表现

执行grails create-app login命令时，系统返回错误信息：

Error occurred running Grails CLI: SSL peer shut down incorrectly

问题排查过程

1. 初步检查：首先确认了JDK和Grails版本都是兼容的，环境变量配置正确。

2. 网络连接测试：通过外部工具测试repo.grails.org的443端口SSL连接，确认服务器端SSL证书配置正常。

3. 本地网络配置检查：最终发现问题出在本地系统的/etc/hosts文件中存在错误配置，导致SSL握手失败。

解决方案

修正/etc/hosts文件中的错误配置后，Grails能够正常连接到中央仓库并创建新项目。

经验总结

1. 当遇到SSL连接问题时，首先应该检查本地网络配置，特别是hosts文件。

2. 对于Grails项目创建失败的情况，除了检查Grails和JDK版本外，网络连接也是常见的问题点。

3. 在Linux系统中，/etc/hosts文件的错误配置可能导致各种网络连接问题，包括SSL握手失败。

最佳实践建议

1. 定期检查系统hosts文件，确保没有错误的域名解析配置。

2. 在遇到SSL连接问题时，可以使用openssl等工具测试目标服务器的SSL证书是否有效。

3. 对于Grails项目，建议在创建新项目前先测试网络连接是否正常。

这个问题虽然最终发现是本地配置问题，但它提醒我们在开发过程中要全面考虑各种可能性，从最简单的配置开始排查，往往能快速解决问题。