FastAPI GET接口正常返回但curl -I请求报405，负载均衡健康检查失败求助

问题原因 #

curl -I 命令发起的是HEAD请求，而你通过@app.get('/health')定义的接口仅支持GET方法。FastAPI默认不会自动为GET接口处理HEAD请求，因此负载均衡器用HEAD做健康检查时，就会返回405 Method Not Allowed错误。

解决建议 #

方法1：为单个GET接口添加HEAD支持 #

修改路由装饰器，显式指定同时支持GET和HEAD方法：

@app.get('/health', methods=['GET', 'HEAD'])
async def health():
    """Returns health status"""
    return JSONResponse({'status': 'ok'})

或者使用api_route装饰器更清晰地声明支持的方法：

@app.api_route('/health', methods=['GET', 'HEAD'])
async def health():
    """Returns health status"""
    return JSONResponse({'status': 'ok'})

修改后，FastAPI会自动处理HEAD请求，返回符合规范的响应头（不会返回响应体），状态码为200 OK。

方法2：全局开启所有GET接口的HEAD支持 #

如果你的应用中有大量GET接口，不想逐个修改，可以在初始化FastAPI实例时设置allow_head=True，让所有GET路由自动支持HEAD请求：

from fastapi import FastAPI

app = FastAPI(allow_head=True)

@app.get('/health')
async def health():
    """Returns health status"""
    return JSONResponse({'status': 'ok'})

验证方法 #

修改完成后，执行curl -I http://172.xx.xx.xx:8080/health测试，应该返回200状态码及正常的响应头，负载均衡器的健康检查即可恢复正常。

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