本文详解如何在 Spring MVC 的 @RequestMapping 中通过正则表达式匹配“不包含 'api' 字符串”的请求路径，纠正常见误区并提供安全、可维护的替代方案。
本文详解如何在 spring mvc 的 `@requestmapping` 中通过正则表达式匹配“不包含 'api' 字符串”的请求路径，纠正常见误区并提供安全、可维护的替代方案。
在 Spring MVC 中，直接使用 @RequestMapping("/^(?!api$).*$") 这类正则表达式无法按预期工作——因为 Spring 默认的 AntPathMatcher 不支持 Java 风格的负向先行断言（(?!)），它仅支持 Ant 风格通配符（如 **、*、?），而非完整正则。上述写法会导致路径匹配失效或 404 错误。
✅ 正确做法：启用 PathPatternParser（Spring 5.3+ 推荐）或采用逻辑反转 + 显式排除策略。
✅ 推荐方案一：使用 @RequestMapping 配合 @GetMapping 多路径声明（简洁可靠）
@Controller
public class RouterController {
// 匹配所有非 /api 开头的根级路径（例如 /home, /user, /login）
@GetMapping({"/", "/home", "/user", "/login", "/about"})
public String app() {
return "app-view";
}
// 显式排除 /api 及其子路径（优先级更高，确保不落入上一规则）
@GetMapping("/api/**")
@ResponseStatus(HttpStatus.NOT_FOUND)
public void apiBlocked() {
// 或重定向、返回错误页等
}
}✅ 推荐方案二：使用 @RequestMapping 的 headers 或 params 辅助控制（适用于条件路由）
若需更动态判断，建议将逻辑移至方法体内：
@Controller
public class RouterController {
@RequestMapping(value = "/**", method = RequestMethod.GET)
public String app(HttpServletRequest request) {
String uri = request.getRequestURI();
// 安全判断：不区分大小写，排除含 "api" 的路径（可根据需求调整为 startsWith 或 contains）
if (uri.toLowerCase().contains("api")) {
throw new ResponseStatusException(HttpStatus.NOT_FOUND, "API endpoints are excluded from this handler");
}
return "app-view";
}
}⚠️ 注意事项：
- ❌
@RequestMapping("/^(?!api).*$")在标准 Spring Boot（默认 AntPathMatcher）下无效，勿直接复制使用； - ✅ 若坚持用正则，需切换为
PathPatternParser（Spring Boot 2.6+ 默认启用），但PathPattern仍不支持负向断言，仅支持/{*path}通配和简单匹配； - ? 生产环境推荐显式声明白名单路径 + 单独拦截 API 路径，语义清晰、性能更高、便于审计；
- ? 如需全局过滤，可结合
HandlerInterceptor或Filter实现统一 URL 检查逻辑。
总结：Spring 路由设计应遵循“显式优于隐式”原则。与其依赖易出错的正则排除，不如通过分层路由（白名单 + 显式拦截）或业务层判断实现更健壮、可读性更强的请求分发逻辑。
