SpringBoot @PostMapping本地正常，部署至GCP后无法使用

问题详情 #

我的SpringBoot应用控制器方法使用如下注解：

@PostMapping(
    value = "/api/receivepayload",
    consumes = MediaType.APPLICATION_XML_VALUE,
    produces = MediaType.APPLICATION_XML_VALUE)

本地环境通过Postman测试POST请求完全正常，但部署到Google Cloud（GCP）后，使用公网URL访问时出现以下错误：

{
    "timestamp": "2023-07-21T13:25:02.618+00:00",
    "status": 405,
    "error": "Method Not Allowed",
    "path": "/"
}

再次测试GCP上的服务时，日志输出如下：

2023-07-21T13:24:45.257Z INFO 287041 --- [nio-8080-exec-1] o.a.c.c.C.[Tomcat].[localhost].[/] : Initializing Spring DispatcherServlet 'dispatcherServlet'
2023-07-21T13:24:45.258Z INFO 287041 --- [nio-8080-exec-1] o.s.web.servlet.DispatcherServlet : Initializing Servlet 'dispatcherServlet'
2023-07-21T13:24:45.260Z INFO 287041 --- [nio-8080-exec-1] o.s.web.servlet.DispatcherServlet : Completed initialization in 1 ms
2023-07-21T13:25:02.616Z WARN 287041 --- [nio-8080-exec-4] .w.s.m.s.DefaultHandlerExceptionResolver : Resolved [org.springframework.web.HttpRequestMethodNotSupportedException: Request method 'POST' is not supported]

排查及解决方向 #

1. 确认请求路径完整性 #

错误返回的path是"/"，但你的接口实际路径是"/api/receivepayload"，先检查Postman请求的公网URL是否完整拼接了接口路径。比如公网地址是https://xxx.gcp.com，完整请求URL应该是https://xxx.gcp.com/api/receivepayload，而非仅请求根路径。

2. 检查GCP负载均衡/Ingress配置 #

如果使用了GCP的负载均衡或Ingress组件，核实是否存在路径重写规则，导致请求被错误转发到根路径而非目标接口路径。重点确认Ingress的路径映射是否正确配置了/api/receivepayload指向你的服务端口。

3. 核对服务上下文路径配置 #

检查SpringBoot应用的server.servlet.context-path配置项（在application.properties或application.yml中），如果本地环境配置了上下文路径，但部署到GCP时未同步配置，会导致路径匹配失败。若有配置，请求URL需要包含上下文路径。

示例配置：

server.servlet.context-path=/your-custom-context

4. 检查App Engine的handlers配置（如果部署在App Engine） #

查看app.yaml中的handlers规则，确保路径匹配规则正确，且未限制POST方法。示例正确配置：

handlers:
  - url: /.*
    script: auto

5. 确认请求头Content-Type设置 #

你的接口要求consumes = MediaType.APPLICATION_XML_VALUE，即请求头必须包含Content-Type: application/xml。GCP环境可能对请求头校验更严格，若未正确设置，会导致路由匹配失败，最终 fallback到根路径触发405错误。

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