Angular应用部署至JBoss 7遇刷新404：求URL重写配置方法

我正好碰到过类似的情况，Angular的客户端路由在JBoss 7下刷新就跳404，本质是服务器不知道要把这些路由请求转发到index.html。下面给你两种实用的配置方法，完美对应你之前Tomcat的Rewrite规则需求：

方法一：使用Undertow处理规则文件（推荐，语法简洁） #

JBoss 7默认用Undertow作为Web服务器，我们可以直接在WAR包的WEB-INF目录下创建undertow-handlers.conf文件，添加以下规则：

# 匹配所有以/dashboard开头的请求，排除真实存在的文件和目录，重写到index.html
path-prefix('/dashboard') and not file and not dir -> rewrite('/dashboard/index.html')

# 可选：排除静态资源（避免css/js等文件被错误重写），如果你的静态资源有固定后缀可以加上
path-prefix('/dashboard') and regex('.*\.(css|js|png|jpg|ico|svg)$') -> done

这个规则和你Tomcat里的逻辑完全一致：只有当请求不是真实文件/目录时，才转发到index.html，交给Angular路由系统处理。

方法二：通过jboss-web.xml配置重写规则 #

如果偏好XML配置方式，可以在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_7_0.xsd"
           version="7.0">
    <!-- 设置你的应用上下文路径，对应你Tomcat里的/dashboard -->
    <context-root>/dashboard</context-root>
    
    <rewrite>
        <rule>
            <!-- 排除静态资源请求 -->
            <condition test="not regex('/dashboard/.*\.(css|js|png|jpg|jpeg|gif|ico|svg)$')" />
            <!-- 排除真实存在的文件 -->
            <condition test="not file" />
            <!-- 排除真实存在的目录 -->
            <condition test="not dir" />
            <!-- 重写到index.html -->
            <substitution value="/dashboard/index.html" />
        </rule>
    </rewrite>
</jboss-web>

部署注意事项 #

• Angular生产构建：运行ng build --configuration production（旧版本用ng build --prod），把dist文件夹里的所有内容放到WAR包的根目录下（index.html要在WAR根路径）。
• WAR包结构：确保WEB-INF目录在WAR根下，里面放上面的配置文件以及必要的web.xml（最简版web.xml可以只配置欢迎页为index.html）。
• 测试：部署后先访问/dashboard确认正常加载，再刷新路由页面（比如/dashboard/users），验证不会出现404错误。

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