Angular2打包Java应用中使用PathLocationStrategy遇刷新404问题求助

这个问题太常见了！我帮好几个团队排查解决过类似的情况，核心原因其实是PathLocationStrategy的工作逻辑和JBoss EAP这类Java EE服务器的请求处理机制不匹配，咱们一步步理清楚原因和解决办法：

为什么刷新会触发404？ #

当你用PathLocationStrategy时，Angular会把路由路径直接放在URL里（比如your-app.com/user/profile），而非带#的哈希模式。正常访问时，浏览器从根路径加载Angular应用，后续导航全由Angular路由系统接管。但当你刷新页面或直接在地址栏输入路由路径时，浏览器会直接向JBoss EAP发送GET /user/profile的请求——而JBoss根本不知道这个路径对应的资源，它只会去webapp目录下找是否有user/profile.html或对应的Servlet映射，找不到就返回404了。

可行的解决办法 #

1. 配置JBoss的rewrite子系统（推荐） #

这是最优雅的方案，让JBoss把所有非静态资源的请求转发到Angular的入口文件（一般是index.html）。

操作步骤：

• 在你的WAR包的WEB-INF目录下创建/编辑jboss-web.xml文件，添加以下配置：

<jboss-web xmlns="http://www.jboss.com/xml/ns/javaee"
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
           xsi:schemaLocation="http://www.jboss.com/xml/ns/javaee http://www.jboss.org/j2ee/schema/jboss-web_10_0.xsd"
           version="10.0">
    <rewrite>
        <rewrite-rule name="Angular Routes" pattern="^((?!\.(js|css|html|png|jpg|jpeg|gif|ico|svg)$).)*$">
            <substitution>/index.html</substitution>
        </rewrite-rule>
    </rewrite>
</jboss-web>

这个规则会匹配所有非静态资源（js、css、图片等）的请求，自动转发到index.html，让Angular接管路由处理。

2. 使用Servlet过滤器转发请求 #

如果你的JBoss版本不支持rewrite子系统，或者更倾向用Java代码控制，可以写一个简单的Servlet过滤器：

操作步骤：

• 创建过滤器类：

import javax.servlet.*;
import javax.servlet.annotation.WebFilter;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;

@WebFilter("/*")
public class AngularRouteFilter implements Filter {

    @Override
    public void init(FilterConfig filterConfig) throws ServletException {}

    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {
        HttpServletRequest req = (HttpServletRequest) request;
        String path = req.getRequestURI().substring(req.getContextPath().length());

        // 跳过API请求、静态资源和根路径请求
        if (!path.startsWith("/api") && !path.contains(".") && !req.getRequestURI().equals(req.getContextPath())) {
            request.getRequestDispatcher("/index.html").forward(request, response);
            return;
        }

        chain.doFilter(request, response);
    }

    @Override
    public void destroy() {}
}

• 将这个过滤器打包到WAR包中，它会自动把符合条件的请求转发到index.html。

3. 配置base-href（必要前提） #

不管用上面哪种方案，都要确保打包Angular应用时指定了正确的base-href——因为你的应用部署在JBoss的webapp子目录下（比如webapp/your-app），打包时执行：

ng build --prod --base-href="/your-app/"

这样Angular才能正确解析路由路径，避免资源加载失败。

验证方法 #

部署修改后的WAR包到JBoss EAP后：

• 正常访问应用，导航到任意路由（比如/user/profile）
• 刷新页面，应该不会再出现404，Angular会正确加载对应的路由组件

内容的提问来源于stack exchange，提问作者Shyam Kumar Sundarakumar