FastAPI POST接口带/不带尾部斜杠调用返回405问题咨询

1. 单路由带尾斜杠访问无斜杠返回405的原因 #

• 你使用的Starlette 0.13.6属于旧版本，路径斜杠匹配的重定向逻辑存在缺陷：当注册的路由带尾部斜杠/method/final_path/，访问无斜杠的/method/final_path时，Starlette默认返回302状态码触发重定向。
• 302重定向的标准处理逻辑会将原POST请求自动转换为GET请求发送到重定向后的地址，而你仅注册了POST类型的接口，自然返回405 Method Not Allowed。
• 官方文档提到的「尾部斜杠不影响匹配」是高版本FastAPI/Starlette的优化特性，旧版本未实现POST请求重定向时保留原请求方法的307/308状态码逻辑。

2. 同时注册两个路由仍失效的原因 #

• 全局斜杠重定向逻辑未关闭：FastAPI默认开启redirect_slashes参数，访问无斜杠路径时会优先触发重定向逻辑，不会匹配到你注册的无斜杠路由，需要在创建实例时显式关闭：

app = FastAPI(redirect_slashes=False)

• 路由注册顺序冲突：如果存在其他前缀相同的路由先完成注册，可能会提前拦截你的/method/final_path请求，导致匹配失效。
• 上层代理路径改写：如果服务前部署了Nginx等反向代理，可能存在自动补全斜杠或路径改写的规则，导致请求还未到达FastAPI就被修改。

适配方案 #

• 优先升级依赖：将FastAPI升级至0.65及以上、Starlette升级至0.14.2及以上，对应版本修复了重定向逻辑，会自动返回307/308状态码保留原请求方法，无需额外注册双路由即可兼容带/不带尾斜杠的访问。
• 无法升级的场景下，关闭redirect_slashes参数后再同时注册两个路由，即可正常兼容两种路径的POST请求。

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