Kotlin集成MongoDB时@PathVariable接收Get请求失败求助

AI 小北

2026-7-6

问题描述

在Kotlin环境中集成MongoDB开发接口时遇到以下问题：编写的GET接口通过@PathVariable接收路径参数，但发起请求后无法进入接口方法（控制台未执行println(pidString)语句），返回400错误，且请求的ID确实存在。

Controller代码：

@GetMapping("/{id}/")
suspend fun getProject(@PathVariable pidString: String): ResponseEntity<ProjectDTO> {
    return withContext(Dispatchers.IO) {
        println(pidString)
        val pid = projectService.validateURLProjectId(pidString)
        ResponseEntity.ok(projectService.getProject(pid))
    }
}

API请求：

http://localhost:8080/65461bff3f2baf0938c6f22e/

错误响应：

{
    "status": "BAD_REQUEST",
    "code": 400,
    "timestamp": "2023-11-04T14:07:32.925505",
    "message": "500 INTERNAL_SERVER_ERROR \"pidString\""
}

怀疑问题出在@PathVariable上，求排查思路。

排查思路

对齐路径变量名与参数名：路径里定义的是{id}，但参数名是pidString，Spring默认要求二者一致，或者显式指定value属性，比如改成@PathVariable(value = "id") pidString: String；也可以确保Kotlin编译时保留参数名（添加-parameters编译参数），让Spring能正确识别参数名。
测试路径末尾斜杠的影响：接口注解带了末尾斜杠/{id}/，请求也带了斜杠，部分场景下Spring路径匹配对斜杠敏感，可尝试去掉接口注解的末尾斜杠（改为@GetMapping("/{id}")），同时请求也去掉末尾斜杠再测试。
检查全局异常处理器：错误信息里同时出现400和500，大概率是参数绑定阶段抛出异常后被全局处理器转换成了400响应。暂时关闭全局异常处理器，查看原始500错误栈，定位具体异常原因。
验证协程兼容性：接口用了suspend关键字，需确保Spring版本为5.3+，且正确引入kotlin-coroutines-spring等相关依赖，否则可能导致请求处理流程异常。
测试简单路径变量：用test123这类简单字符串作为路径参数发起请求，排除MongoDB ID包含特殊字符导致的解析失败。
开启Spring DEBUG日志：配置logging.level.org.springframework.web=DEBUG，查看请求匹配、参数绑定的详细日志，从中找到路径匹配失败或参数绑定错误的具体信息。

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