本文详解如何在Spring MVC中通过@RequestMapping配合负向先行断言正则表达式，实现“仅匹配不包含‘api’的请求路径”，并指出原方案中的常见误区与正确实践。
本文详解如何在spring mvc中通过`@requestmapping`配合负向先行断言正则表达式，实现“仅匹配不包含‘api’的请求路径”，并指出原方案中的常见误区与正确实践。
在Spring MVC中，@RequestMapping默认支持Ant风格路径（如/api/**），但不直接支持Java标准正则表达式语法（如(?!)）。因此，问题中给出的写法 @RequestMapping({"/^(?!api$).*$"}) ❌ 在Spring Boot 2.x/3.x中无法生效——该写法会被当作字面量路径处理，而非正则匹配，导致404或误匹配。
✅ 正确做法是：启用正则表达式支持，需满足两个前提：
- 使用
@RequestMapping的path属性（或其别名value）并以**开头 + 正则语法包裹； -
显式启用
pattern模式 —— Spring 实际通过PathPatternParser（Spring Boot 2.6+ 默认）或AntPathMatcher（旧版）解析路径，而*原生正则需借助@RequestMapping的path配合 `.通配 +@Pattern等AOP方式，或更推荐使用@GetMapping+@PathVariable+@Pattern校验，但最简洁可靠的方式是采用@RequestMapping的正则路径模式（需开启use-regex=true`）**。
⚠️ 注意：Spring Boot 2.6+ 已弃用 AntPathMatcher，默认使用高性能 PathPatternParser，它不支持任意正则，仅支持有限的路径模式（如 `,*,{var}）**。因此，要实现「排除含api` 的路径」，应采用反向路由设计 + 多级映射优先级，而非硬编码正则：
✅ 推荐方案：利用Spring MVC路径匹配优先级（最稳定、兼容性最佳）
@Controller
public class RouterController {
// 1️⃣ 高优先级：精确匹配 /api 及其子路径（拦截所有 API 请求）
@RequestMapping("/api/**")
public String handleApiRequests() {
return "forward:/error/api-not-allowed"; // 或返回403/重定向
}
// 2️⃣ 低优先级：匹配其余所有非API路径（注意：必须放在 @RequestMapping("/api/**") 之后！）
@RequestMapping("/**")
public String app() {
// 此方法仅处理不含 "/api" 前缀的请求（如 /home, /user, /login）
return "app-layout";
}
}
? 原理：Spring MVC 按
@RequestMapping声明顺序匹配，更具体的路径（`/api/）会先于泛路径（/`）被选中。因此/api/users走第一个方法，/home则落入第二个方法——天然实现“排除api”逻辑。
⚠️ 补充说明与注意事项
- ❌ 不要尝试
@RequestMapping("/^(?!.*api).*$/")：PathPatternParser会将其视为非法路径，启动报错或静默失败； - ✅ 若必须用正则（如匹配
/user/{id:[0-9]+}），可对路径变量使用正则约束，但全路径排除仍推荐优先级方案； - ? 若需全局排除（如静态资源、Swagger等），建议结合
WebMvcConfigurer自定义ResourceHandlerRegistry或HandlerMapping； - ? 安全提示：业务逻辑中仍需校验请求来源，路径排除不能替代权限控制（如
@PreAuthorize）。
总结
在Spring生态中，“排除某类URL”不应依赖不可靠的正则路径，而应善用路径匹配的 specificity 机制：先声明高特异性规则（如 /api/**），再用泛路径兜底。这既符合框架设计哲学，又具备跨版本稳定性，是生产环境的最佳实践。
