Spring Boot Swagger项目部署Wildfly出现404 Not Found问题

排查步骤 #

• 检查打包兼容性
  Spring Boot默认生成的是可执行Jar，这种Jar的结构和Wildfly要求的部署包存在差异。可以重新打包，跳过Spring Boot的可执行Jar插件：

  mvn clean package -Dspring-boot.repackage.skip=true
  

  把生成的新Jar放到deployments目录重试。如果项目原本是Jar打包，也可以把pom.xml里的<packaging>改成war，重新执行mvn clean install后部署War包。

• 确认上下文路径匹配
  先检查项目配置文件（application.properties/yml）里的server.servlet.context-path属性，如果设置了自定义路径，访问时要加上这段路径，比如配置了server.servlet.context-path=/demo，那访问地址应该是http://localhost:8080/demo。
  另外Wildfly部署Jar时，默认上下文路径是Jar文件名（去掉.jar），如果项目没有自定义路径，也可以试试访问http://localhost:8080（Spring Boot默认根路径），有些情况下Wildfly会把部署的Jar映射到根路径。

• 深挖Wildfly日志
  控制台没报错不代表项目真的启动了，去wildfly-folder\standalone\log目录打开server.log，搜索关键词：

  • SpringApplication：查看是否有Spring Boot启动的日志
  • demo-api-service：查找项目相关的部署细节
    如果日志里看不到Spring Boot的启动信息，说明Wildfly没正确识别这个Jar的结构，还是打包方式的问题。

• 验证项目本身可用性
  先用java -jar demo-api-service.jar直接运行Jar包，本地访问http://localhost:8080（或自定义端口/路径），看Swagger UI能不能正常打开。如果直接运行也404，那是项目本身的问题，比如Swagger配置有误；如果能正常访问，就聚焦Wildfly的部署适配。

• 核对Wildfly部署配置
  登录Wildfly管理控制台，进入Deployments页面，找到demo-api-service，查看它的Context Root是否和你访问的路径一致。如果不一致，手动修改Context Root后重新部署。

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