SpringBoot访问/及非/mealplanner/路径返回index.html的配置问题

AI 小北

2026-10-20

配置失效核心原因

你添加的@EnableWebMvc注解会完全覆盖SpringBoot默认的Web自动配置，其中包含静态资源路径映射规则，因此forward请求找不到classpath:/static下的index.html
addViewController仅支持固定路径映射，无法适配你需要匹配「除/mealplanner/前缀外所有路径」的需求

可行解决方案

步骤1：修复静态资源映射

如果你没有自定义拦截器、跨域等强依赖@EnableWebMvc的需求，直接删除该注解即可恢复SpringBoot默认静态资源映射规则；如果必须保留@EnableWebMvc，在你的WebConfig类中补充静态资源映射配置：

@Configuration
@EnableWebMvc
public class WebConfig implements WebMvcConfigurer {
    // 补充静态资源映射
    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("/**")
                .addResourceLocations("classpath:/static/");
    }
}

步骤2：新增SPA路由转发控制器

利用SpringMVC路径匹配优先级（精确匹配 > 通配符匹配）的特性，/mealplanner/前缀的业务接口会优先命中你的业务Controller，其余路径全部转发到index.html，全程不会改变浏览器URL：

@Controller
public class SpaRouteController {
    // 匹配根路径、所有不带后缀的路径（排除js/css/png等静态资源请求）
    @RequestMapping(value = {"/", "/**/{path:[^\\.]*}"})
    public String forwardToIndex() {
        return "forward:/index.html";
    }
}