JHipster构建的React单体应用部署AWS后访问404如何解决

排查步骤 #

• 确认上下文路径匹配：JHipster默认打出的WAR包部署到外置Tomcat时，会自动以WAR包文件名作为上下文路径，比如WAR包名为vpark-0.0.1-SNAPSHOT.war，则默认访问路径为http://xxx.us-west-1.elasticbeanstalk.com/vpark-0.0.1-SNAPSHOT/，先尝试访问带包名后缀的地址，确认是否是路径不匹配导致的404。
• 查看应用启动日志：进入Elastic Beanstalk控制台的「日志」页面，下载完整的Catalina运行日志，排查是否存在应用启动失败的报错，常见原因包括Java版本不兼容、数据库连接失败、配置参数缺失等。
• 校验WAR包结构：解压本地构建出的WAR包，确认WEB-INF/classes目录下存在编译后的业务代码，WEB-INF/lib包含全部依赖包，静态资源文件（js、css、html）在指定目录下存在。

具体解决方案 #

解决404报错问题 #

1. 上下文路径适配：
   • 可以将构建好的WAR包重命名为ROOT.war，Tomcat会自动将该包映射为根路径应用，直接访问域名根目录即可打开。
   • 也可以在Elastic Beanstalk控制台「配置」→「软件」→「容器选项」中，将上下文路径设置为/。
2. 启动失败修复：
   • 确认本地编译使用的Java版本和部署环境的Java 8完全一致，避免高版本编译的class文件无法在低版本JRE运行的问题。
   • 检查生产环境配置文件application-prod.yml中的数据库连接逻辑，确认可以正确读取Elastic Beanstalk自动注入的RDS连接参数，避免数据库连接失败导致应用启动终止。

解决平台弃用问题 #

当前使用的Tomcat 8.5+Java 8的Amazon Linux平台已停止维护，推荐更换为更稳定的Amazon Linux 2+Corretto运行环境，无需依赖外置Tomcat：

• 修改项目打包配置，将bootWar改为bootJar，构建内嵌Servlet容器的可执行JAR包。
• 在Elastic Beanstalk控制台新建环境，平台选择对应你项目Java版本的Corretto运行环境（如Corretto 17），平台分支选择Amazon Linux 2。
• 上传构建好的JAR包部署即可，后续也可以升级JHipster到最新稳定版，调整jhipster aws生成配置，实现自动化部署到新的Java运行平台。

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