spring-boot对context-path的请求/为静态内容生成405不允许的方法错误

基础概念

context-path 是 Spring Boot 应用中的一个配置，用于指定应用的上下文路径。例如，如果将 context-path 设置为 /myapp，那么所有请求都需要通过 /myapp 前缀来访问应用。

问题描述

当你在 Spring Boot 应用中设置 context-path 后，访问根路径 / 时可能会遇到 405 Method Not Allowed 错误。这是因为 Spring Boot 默认情况下不会处理根路径的请求，而是将其交给静态资源处理器。

原因分析

静态资源处理器：Spring Boot 默认将根路径 / 的请求交给静态资源处理器，而静态资源处理器不支持 GET 以外的请求方法。
缺少映射配置：如果应用中没有为根路径 / 配置任何处理方法，那么访问根路径时会返回 405 Method Not Allowed 错误。

解决方法

方法一：配置静态资源路径

确保你的静态资源路径配置正确。例如，可以在 application.properties 中添加以下配置：

spring.resources.static-locations=classpath:/static/

方法二：添加根路径处理方法

你可以在控制器中添加一个处理根路径 / 的方法。例如：

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HomeController {

    @GetMapping("/")
    public String index() {
        return "Hello, World!";
    }
}

方法三：配置默认页面

如果你希望访问根路径时显示一个默认页面，可以在 src/main/resources/static 目录下创建一个 index.html 文件。

示例代码

以下是一个完整的示例，展示了如何在 Spring Boot 应用中处理根路径 / 的请求：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@SpringBootApplication
public class MyApplication {

    public static void main(String[] args) {
        SpringApplication.run(MyApplication.class, args);
    }

    @RestController
    public class HomeController {

        @GetMapping("/")
        public String index() {
            return "Hello, World!";
        }
    }
}