Spring Controller根路径定位及默认路径配置异常问题

你遇到的问题是根路径http://localhost:8080无法触发Controller方法，但/index可以正常访问，核心原因主要有两个：

• 静态资源优先级拦截：如果项目src/main/resources/static或public目录下存在index.html，Spring会优先加载这个静态页面，跳过Controller的根路径映射。
• 请求映射匹配模糊：未明确指定请求方法（如GET/POST）的@RequestMapping，可能存在匹配逻辑冲突，导致根路径请求无法正确路由到目标方法。

最简解决方案：合并路径映射 #

直接将/和/index映射到同一个方法，既解决问题又消除重复代码：

@Controller
public class RecipeController {

    @Autowired
    private RecipeService service;

    // 同时处理根路径与/index路径的GET请求
    @GetMapping(value = {"/", "/index"})
    public String index(Model model) {
        List<Recipe> recipes = service.fetchAll();
        model.addAttribute("recipes", recipes);
        return "index";
    }
}

其他可选方案 #

方案1：转发根路径到/index

如果不想修改现有方法，可通过配置视图控制器将根路径请求转发到/index：

@Configuration
public class WebMvcConfig implements WebMvcConfigurer {
    @Override
    public void addViewControllers(ViewControllerRegistry registry) {
        // 根路径请求转发至/index，复用已实现的业务逻辑
        registry.addViewController("/").setViewName("forward:/index");
    }
}

方案2：调整静态资源访问规则（若需保留index.html）

如果必须保留静态目录下的index.html，可通过配置文件修改静态资源的访问路径，避免拦截根路径：

# application.properties
spring.mvc.static-path-pattern=/static/**

修改后，仅访问/static/index.html会加载静态页面，根路径请求将正常走Controller映射。

原配置无效的原因 #

你两次尝试的配置中，根路径映射未明确指定请求方法（如@GetMapping），或被静态资源的默认优先级拦截，导致Spring无法正确触发对应的Controller方法。明确请求方法、合并路径映射，都能解决这个匹配模糊的问题。

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