Spring Boot REST应用部署外部Tomcat遇401认证错误求助

我来帮你梳理下部署到外部Tomcat后出现401的常见排查方向，这些都是我处理类似问题时的常用思路：

• 上下文路径不匹配
  嵌入式Tomcat默认用根路径(/)作为应用上下文，但外部Tomcat部署WAR包后，会自动以WAR文件名作为上下文路径（比如你的WAR叫my-app.war，上下文路径就是/my-app）。如果你的前端请求或者Spring Security配置里的接口路径还是按根路径写的（比如/api/login），实际部署后正确的请求路径应该是/my-app/api/login，请求路径错误会被Security拦截返回401。
  建议：检查请求URL是否包含正确的上下文路径；在Spring Security配置中优先使用mvcMatchers()替代antMatchers()，因为mvcMatchers()会自动适配Spring MVC的上下文路径，避免硬编码路径问题。

• WAR打包依赖冲突
  确保你在pom.xml中将Spring Boot的嵌入式Tomcat依赖设置为provided范围，否则外部Tomcat的容器依赖会和嵌入式Tomcat的依赖冲突，导致Security过滤器链无法正常初始化：

  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-tomcat</artifactId>
      <scope>provided</scope>
  </dependency>
  

  同时确认packaging标签设置为war：

  <packaging>war</packaging>
  

• SpringBootServletInitializer配置不全
  你的Application类继承了SpringBootServletInitializer，但重写的configure方法是否正确？正确的实现应该是：

  @Override
  protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {
      return application.sources(Application.class);
  }
  

  如果这个方法没正确实现，Spring容器可能无法正常加载Security配置，导致所有请求被默认拦截规则拒绝。

• 外部Tomcat权限问题
  检查Tomcat的webapps目录下的WAR包是否正确解压，应用目录的读写权限是否足够（Tomcat运行用户需要能访问应用的临时文件、日志、数据库连接配置等）。权限不足可能导致Security相关组件（比如JWT密钥加载、数据库认证查询）无法正常工作，进而返回401。

• 开启Security日志定位问题
  在application.properties中添加日志配置，开启Spring Security的DEBUG级日志：

  logging.level.org.springframework.security=DEBUG
  

  然后查看Tomcat的catalina.out或localhost.log，观察登录请求到达时的过滤器链处理流程——比如是认证凭证无效、路径匹配失败，还是过滤器未正确加载，日志会给出明确的错误线索。

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