SpringBoot旧项目Post请求报405 Method Not Allowed求助

问题描述 #

一周前正常运行的旧SpringBoot项目（Kotlin语言，build.gradle.kts构建），现在发送POST请求 http://127.0.0.1:8080/user/122?name=shre12 时返回405错误：

{
    "timestamp": "2023-07-09T01:42:56.979+00:00",
    "status": 405,
    "error": "Method Not Allowed",
    "path": "/user/122"
}

将相同代码复制到新项目可正常运行，已尝试重建项目、清除IDE缓存、重启IDE，问题仍存在。

相关代码如下：

Controller.kt #

@RestController
class Controller(private var userService: UserService) {

    @PostMapping("/user/{id}")
    fun newStudent(
        @PathVariable id: String,
        @RequestParam("name") name: String
    ): ResponseEntity<String> {
        return try {
            val userResponse = JSONObject()
            val user = UserDocument(id, name)
            userResponse.put("addUser", user)

            val userSignUp = UserDocument(id, name)
            userService.addUser(userSignUp)

            ResponseEntity
                .status(HttpStatus.FOUND)
                .contentType(MediaType.APPLICATION_JSON)
                .body(userSignUp.toString())
        } catch (e: IOException) {
            ResponseEntity(e.message, HttpStatus.INTERNAL_SERVER_ERROR)
        }
    }
}

Model.kt #

@Document(collection = "usersData")
data class UserDocument(
    @Id
    val id: String? = null,
    val name: String
)

Repository.kt #

interface UserRepository : MongoRepository<UserDocument?, Int?> {}

Service.kt #

@Service
class UserService(private val userRepository: UserRepository) {

    fun addUser(user: UserDocument) {
        val processedUser = user.copy(
            id = user.id,
            name = user.name
        )
        userRepository.save(processedUser)
    }
}

排查方向 #

1. 检查自动配置端点冲突

   • 旧项目可能引入了spring-boot-starter-data-rest这类依赖，Spring Data REST会自动为MongoRepository生成默认REST端点，/user/{id}会被映射为GET请求，和自定义POST端点冲突。对比新项目的build.gradle.kts依赖，移除可疑依赖测试。

2. 检查过滤器/拦截器限制

   • 旧项目可能新增了自定义拦截器、过滤器，或引入Spring Security等安全组件，这些组件可能拦截了/user/{id}的POST请求，仅允许特定HTTP方法访问。检查项目中的配置类，确认是否有相关限制逻辑。

3. 检查路径匹配规则差异

   • 对比新旧项目的SpringBoot版本，不同版本的路径匹配策略（如spring.mvc.pathmatch.matching-strategy配置）可能不同。查看旧项目的application配置文件，确认是否开启了严格匹配导致请求无法命中控制器方法。

4. 检查控制器扫描范围

   • 确认旧项目中带@SpringBootApplication的主类，其所在包是否能覆盖Controller类的包路径，避免因组件扫描范围问题导致控制器未被注册。可在主类或控制器上添加@ComponentScan指定扫描路径。

5. 查看请求映射日志

   • 启动旧项目时开启DEBUG日志级别，搜索RequestMappingHandlerMapping相关日志，确认/user/{id}的POST方法是否被正确注册，是否存在其他映射覆盖该路径。

6. 清理构建残留

   • 执行./gradlew clean build清理项目的build目录，重新构建，避免旧编译文件残留。同时检查是否有环境配置文件（如application-dev.yml）覆盖了默认逻辑。

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