Azure部署Spring Boot REST API时GET与POST同URL方法冲突问题

核心问题 #

你的Spring Boot REST API在Azure部署后，同路径的GET /api/v2/patients/{patientId}/settings返回405 Method Not Allowed，仅POST方法被识别，但本地运行正常。这说明问题出在Azure的部署环境配置，而非代码本身。

排查与解决步骤 #

1. 验证Spring Boot请求映射是否正确注册 #

在Azure上启动应用时，检查应用日志是否打印了GET方法的映射记录。可在application.properties中添加以下配置开启调试日志：

logging.level.org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping=DEBUG

重启应用后，查看日志中是否存在类似如下的记录：

Mapped "{[/api/v2/patients/{patientId}/settings],methods=[GET]}" onto public org.springframework.data.domain.Page<com.example.PatientDto> com.example.PatientController.getPatient(java.lang.String,org.springframework.data.domain.Pageable)

如果没有这条日志，说明部署的应用包存在问题（比如依赖缺失、bean加载失败），请确认Azure部署的包和本地测试包完全一致。

2. 检查Azure App Service的web.config配置 #

如果你的应用是打包成JAR部署，Azure会自动生成web.config，但如果有自定义配置，需确保规则允许所有HTTP方法。正确的配置示例如下：

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
  <system.webServer>
    <handlers>
      <add name="httpPlatformHandler" path="*" verb="*" modules="httpPlatformHandler" resourceType="Unspecified"/>
    </handlers>
    <httpPlatform processPath="%JAVA_HOME%\bin\java.exe"
                 arguments="-Djava.net.preferIPv4Stack=true -Dserver.port=%HTTP_PLATFORM_PORT% -jar &quot;%HOME%\site\wwwroot\your-app.jar&quot;">
    </httpPlatform>
  </system.webServer>
</configuration>

重点确认verb="*"，确保所有HTTP方法（包括GET）都能被转发到Spring Boot的内嵌服务器。

3. 排查Azure API Management（APIM）配置（如果使用） #

若你的API前端配置了APIM：

• 登录APIM控制台，找到对应API，检查是否添加了GET方法的操作，且路径与后端完全匹配；
• 检查APIM的入站策略，确认没有阻止GET请求的规则（比如强制方法转换的策略）。

4. 检查CORS配置（若涉及跨域请求） #

如果前端是跨域调用API，确认全局CORS配置或@CrossOrigin注解是否包含GET方法。例如全局配置：

@Configuration
public class CorsConfig implements WebMvcConfigurer {
    @Override
    public void addCorsMappings(CorsRegistry registry) {
        registry.addMapping("/**")
                .allowedOrigins("*")
                .allowedMethods("GET", "POST", "PUT", "DELETE") // 确保包含GET
                .allowedHeaders("*");
    }
}

不过本地运行正常的话，这个问题概率较低，但仍可作为排查项。

5. 确认Azure App Service运行时版本 #

你提到的Spring Boot版本4.7.x应为笔误（Spring Boot无此版本），大概率是Spring Boot 2.7.x。确认Azure App Service的Java运行时版本是否与本地一致，避免版本兼容问题。

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