Maven嵌入式GlassFish部署JAX-WS及静态页404问题求助

• 上下文路径配置不匹配
  嵌入式GlassFish部署Web应用时，未显式指定应用上下文路径的情况下，会自动以应用归档文件名为路径值。多数同类问题的根因是部署时没有将 contextRoot 设置为 /，静态资源实际映射在自定义子路径下，直接访问根路径自然会触发服务器内置的404响应。
  核对方式：在部署逻辑执行完成后，通过 list-applications 的输出结果，确认已部署应用的实际映射路径是否和预期一致。
• 静态资源目录结构不符合加载规范
  嵌入式GlassFish仅识别标准Web应用结构下的静态资源，要求index.html等静态文件必须存放在Maven声明的 Web资源根目录 下。
  常见踩坑场景：将静态文件放在项目根目录、src/main/java源码目录、resources资源目录下，这类路径的文件不会被映射为Web可访问资源，访问时必然返回404。
  核对方式：打印部署阶段Web资源根目录的实际磁盘路径，确认index.html的物理存放位置被包含在该目录的映射范围内。
• 虚拟主机路由绑定错误
  嵌入式实例启动时，默认虚拟主机的文档根指向GlassFish内置的默认静态资源目录，没有和用户部署的Web应用做关联。这种场景下即使应用部署流程正常完成，访问8080、8181端口时服务器会优先从内置文档目录查找资源，找不到时就会返回自带的默认404页面，不会路由到用户部署的应用。
  核对方式：在配置HTTP/HTTPS监听端点时，显式将端口和部署的应用做路由绑定，不要依赖默认的虚拟主机匹配规则。
• 启动时序错位
  部分嵌入式启动逻辑存在流程漏洞：启动方法返回就绪状态时，Web应用的类加载、JAX-WS端点扫描、静态资源映射流程尚未执行完成。此时访问端口只会命中服务器内置的默认响应逻辑，等全部部署流程跑完后资源路径才会生效。
  核对方式：调整启动流程顺序，确保 Web应用部署、资源映射的全部流程执行完成后，再开启HTTP/HTTPS端口的对外监听。
• JAX-WS映射规则拦截静态请求
  如果在web.xml或JAX-WS注解配置中，将服务Servlet的映射路径设置为根路径 /*，且没有配置静态资源放行规则，所有到达根路径的请求都会被导向Web服务处理逻辑，由于无法匹配服务方法的路径规则，就会返回默认404。
  核对方式：检查JAX-WS的Servlet映射配置，将服务端点的路径设置为独立的子路径（例如 /ws/*），不要占用静态资源的根路径访问权限。

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