FastAPI部署ML模型时GET访问POST路由触发405 Method Not Allowed错误

错误根因 #

你给/predict接口绑定的是 POST 请求方法，但直接在浏览器地址栏输入地址访问时，浏览器默认只会发起 GET 请求，请求方法和接口定义不匹配，FastAPI 就会返回405状态码。
FastAPI 自带的/docs交互式测试界面能正常运行，是因为测试面板会按照接口的方法定义发送对应请求，不会出现方法错配的问题。

修复方案 #

根据实际使用场景选择对应调整方式：

• 若需要支持浏览器地址栏直接发起测试：
  把接口上方的装饰器从@app.post('/predict')改成@app.get('/predict')即可，后续的推理逻辑代码不需要做任何改动，修改完成后再访问http://127.0.0.1:8000/predict?data=hello，就能正常返回预测结果。
  *注意：正式对外部署的线上推理服务不建议用GET方法接收推理输入，一是GET请求的参数有长度上限，二是输入内容会被完整记录在浏览器历史、服务器访问日志中，存在数据泄露风险。
• 若计划保留POST接口作为正式服务入口：
  不要用浏览器地址栏的方式测试POST接口，继续使用/docs交互面板、Postman、curl这类支持自定义请求方法的工具测试即可，对应的curl测试命令示例：

  curl -X POST "http://127.0.0.1:8000/predict?data=hello"
  

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