WildFly 32.0.0部署RESTful API后Postman无法访问端点求助

1. 确认应用部署状态 #

• 登录WildFly管理控制台（默认地址http://localhost:9990），进入Deployments页面，确认应用状态为Started，无部署报错。
• 查看服务器日志文件standalone/log/server.log，搜索应用初始化阶段的异常信息，比如JAX-RS注解扫描失败、依赖缺失等。

2. 检查JAX-RS核心配置 #

• 确保应用包含javax.ws.rs.core.Application实现类，或在web.xml中配置JAX-RS Servlet：

  <servlet>
      <servlet-name>javax.ws.rs.core.Application</servlet-name>
      <load-on-startup>1</load-on-startup>
  </servlet>
  <servlet-mapping>
      <servlet-name>javax.ws.rs.core.Application</servlet-name>
      <url-pattern>/api/*</url-pattern>
  </servlet-mapping>
  

• 若采用无web.xml的注解方式，需给Application类添加@ApplicationPath("/api")注解，定义REST端点的统一前缀。

3. 验证网络绑定配置 #

• 打开standalone/configuration/standalone.xml，检查接口与端口绑定：

  <interface name="public">
      <inet-address value="${jboss.bind.address:0.0.0.0}"/>
  </interface>
  <socket-binding-group name="standard-sockets" default-interface="public" port-offset="${jboss.socket.binding.port-offset:0}">
      <socket-binding name="http" port="${jboss.http.port:8080}"/>
  </socket-binding-group>
  

  确保public接口绑定0.0.0.0（允许外部访问），而非默认的127.0.0.1（仅本地可访问）。

4. 核对端点URL格式 #

• Postman访问的完整URL需遵循：http://<服务器IP>:<端口>/<应用上下文根>/<ApplicationPath>/<端点路径>
  示例：应用上下文根为myapp、ApplicationPath为/api、端点路径为/users，则完整URL为http://localhost:8080/myapp/api/users
• WildFly默认对URL路径大小写敏感，需严格匹配端点定义。

5. 排查防火墙与端口限制 #

• 确认WildFly使用的HTTP端口（默认8080）未被本地或服务器防火墙拦截，本地测试可临时关闭防火墙，远程服务器需在防火墙规则中开放对应端口。

6. 检查安全认证配置（若启用） #

• 若REST端点配置了安全约束（如HTTP Basic认证、JWT），需在Postman中添加对应认证信息：
  • HTTP Basic：在Authorization选项卡选择Basic Auth，输入用户名和密码。
  • JWT：在Headers中添加Authorization: Bearer <token>。
• 检查standalone.xml中的安全域配置，确保认证模块规则正确。

7. 基础连通性测试 #

• 使用curl命令获取更详细的错误信息：

  curl -v http://localhost:8080/myapp/api/users
  

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