WebSecurityConfigurerAdapter根路径未自动返回index.html问题求助

看起来你遇到的核心问题是本地内嵌Tomcat运行正常，但部署到外部Tomcat时根路径无法自动跳转index.html，同时因为UI5的要求必须保留webapp目录名称。我来帮你一步步排查解决：

1. 修正静态资源路径配置（application.properties） #

你当前的spring.resources.static-locations=classpath:src/main/webapp配置存在问题——部署到外部Tomcat后，src/main/webapp的内容并不会在classpath下（它会被打包到war包的根目录），正确的配置应该把webapp目录加入静态资源扫描路径：

# 保留Spring Boot默认的静态资源路径，同时添加webapp目录
spring.resources.static-locations=classpath:/META-INF/resources/,classpath:/resources/,classpath:/static/,classpath:/public/,/webapp/
# 配置静态资源的访问路径匹配，确保所有webapp下的资源都能被访问
spring.mvc.static-path-pattern=/**

2. 调整Maven资源插件配置（pom.xml） #

你当前配置的maven-resources-plugin把src/main/webapp复制到target/classes/static，这会导致静态资源被重复打包，反而可能引发冲突。如果你的项目是打包成war部署，Maven War插件会自动把src/main/webapp的内容打包到war根目录，所以可以移除这个copy-resources的执行块：

<!-- 移除以下这段冗余配置 -->
<execution>
  <id>copy-resources</id>
  <phase>validate</phase>
  <goals>
    <goal>copy-resources</goal>
  </goals>
  <configuration>
    <outputDirectory>${basedir}/target/classes/static</outputDirectory>
    <resources>
      <resource>
        <directory>src/main/webapp</directory>
        <filtering>true</filtering>
      </resource>
    </resources>
  </configuration>
</execution>

3. 确保Spring Security允许根路径访问 #

你的WebSecurityConfig中已经做了大部分配置，但可以补充根路径到安全忽略列表，避免拦截：

@Override
public void configure(WebSecurity web) {
    web.ignoring().antMatchers(
        "/v2/api-docs", "/configuration/ui", "/swagger-resources/**", 
        "/configuration/**", "/swagger-ui.html", "/webjars/**", 
        "/index.html*", "/odata.svc/$metadata*",
        "/" // 添加根路径到忽略列表，双重保障
    );
}

同时你在configure(HttpSecurity http)里已经允许了"/"的访问，这部分可以保留，确保根路径请求能顺利到达静态资源处理器。

4. 配置根路径转发（兜底方案） #

如果以上配置后根路径还是无法自动跳转index.html，可以添加一个简单的Controller来处理转发：

@Controller
public class WelcomeController {
    @GetMapping("/")
    public String redirectToIndex() {
        return "forward:/index.html";
    }
}

这个Controller会把根路径的请求直接转发到index.html，确保外部Tomcat环境下能正常跳转。

为什么改名为static能生效？ #

因为Spring Boot默认会扫描classpath:/static/作为静态资源目录，所以改名为static后，根路径能自动识别到index.html，但UI5应用依赖webapp目录的结构或路径规则，所以必须保留原目录名。

按照以上步骤调整后，重新打包war部署到Tomcat，应该就能实现根路径自动返回index.html，同时UI5应用正常运行了。

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