Spring Boot SPA URL重写与路由配置问题求助

首先针对你的问题，咱们先理清核心：路由匹配的优先级顺序是解决这类问题的关键，比复杂的正则排除要可靠得多。

a) 最佳实现方案 #

我推荐采用「分层路由匹配」的思路，按请求的明确程度从高到低处理：

• 第一步：优先处理静态资源
  把/assets/**的路由放在最前面，直接映射到你的静态文件目录。这一步要确保：当资源不存在时，直接返回404，而不是跳转到SPA页面。几乎所有后端框架都支持这种静态资源的精确匹配，而且会优先于其他路由执行。

• 第二步：处理API路由
  接着配置/api/**、/anotherapi/**这类API前缀的路由，交给对应的业务控制器处理。这些是明确的业务接口，优先级要高于SPA的兜底路由。

• 第三步：SPA兜底路由
  最后配置一个匹配所有剩余请求的路由（比如/**），把这些请求转发到/index.htm，启动你的SPA应用。

这种顺序的好处是：只有当请求既不是静态资源，也不是API接口时，才会触发SPA的兜底逻辑，完全避免了误匹配的问题。比如如果静态资源不存在，第一步就会返回404，不会走到第三步；API请求也会被第二步拦截，不会被当成SPA请求处理。

举个Spring Boot的代码示例（如果用其他框架，思路是一样的）：

@Configuration
public class SpaWebConfig implements WebMvcConfigurer {

    // 1. 静态资源配置：优先匹配/assets/**
    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("/assets/**")
                .addResourceLocations("file:/your/static/files/directory/")
                // 确保资源不存在时返回404
                .resourceChain(true)
                .addResolver(new PathResourceResolver() {
                    @Override
                    protected Resource getResource(String resourcePath, Resource location) throws IOException {
                        Resource targetResource = location.createRelative(resourcePath);
                        return targetResource.exists() && targetResource.isReadable() ? targetResource : null;
                    }
                });
    }

    // 2. API路由由@RestController处理，比如：
    // @RestController
    // @RequestMapping("/api")
    // public class ApiController { ... }

    // 3. SPA兜底：所有未匹配的请求转发到index.htm
    @Override
    public void addViewControllers(ViewControllerRegistry registry) {
        registry.addViewController("/**")
                .setViewName("forward:/index.htm");
    }
}

b) 让AntPathMatcher的匹配生效 #

首先要明确：AntPathMatcher用的是自定义通配符规则，不是标准正则表达式，所以不能直接写正则语法。它的核心规则是：

• ?：匹配单个任意字符（不含/）
• *：匹配任意多个字符（不含/）
• **：匹配任意路径（包含子路径，跨/）

如果你需要用AntPathMatcher来判断请求是否属于要排除的路径（比如静态资源或API），可以这样做：

// 初始化AntPathMatcher
AntPathMatcher pathMatcher = new AntPathMatcher();
// 定义要排除的路径列表
List<String> excludedPaths = Arrays.asList("/assets/**", "/api/**", "/anotherapi/**");

// 判断当前请求是否在排除列表中
String requestUri = request.getRequestURI();
boolean isExcluded = excludedPaths.stream()
        .anyMatch(excludedPath -> pathMatcher.match(excludedPath, requestUri));

if (!isExcluded) {
    // 转发到index.htm
    request.getRequestDispatcher("/index.htm").forward(request, response);
}

注意事项： #

1. 匹配顺序：如果是在框架中配置路由，一定要确保AntPathMatcher匹配的排除路由优先级高于SPA兜底路由，否则兜底路由会先触发。
2. 大小写敏感：AntPathMatcher默认是大小写敏感的，如果你的路径不区分大小写，可以调用pathMatcher.setCaseSensitive(false);关闭。
3. 不要混用正则：不要试图在AntPathMatcher的路径里写标准正则（比如^、$），它不支持，只用它的通配符规则就足够了。

为什么之前的正则排除容易出错？ #

正则排除需要处理很多边界情况，比如：

• 要确保^锚定路径开头，避免匹配到路径中间的/assets/
• 要处理不带尾部斜杠的路径（比如/api vs /api/）
• 要覆盖所有子路径（比如/api/user/1）
  这些都很容易写错，而AntPathMatcher的**通配符可以完美解决子路径的匹配问题，比正则更直观可靠。

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