405 not allowed API接口报错解决方法

冰火之心

冰火之心

2026-06-24

890人浏览

原创

405错误是服务器拒绝不支持的http方法,需依次确认真实请求方法、检查响应头allow字段、验证后端路由与nginx配置(如limit_except)、排除跨域预检及content-type不匹配问题。

405 not allowed api接口报错解决方法

调用API接口时突然返回“405 Method Not Allowed”,请求发出去了、服务器也收到了,但直接拒收——不是路径错、不是没权限、也不是网络断,而是你用的POST/PUT/DELETE被服务器当场拦下。

先确认浏览器到底发了什么方法

打开浏览器开发者工具→Network标签页→触发报错请求→找到状态码为405的那条记录→点击→在Headers面板里找【Request Method】字段。

如果显示的是OPTIONS,别改后端代码,这是跨域预检请求;如果显示POST但文档写明只支持GET,问题就锁定了。

这一步必须做。很多人坚信自己写了POST,结果抓包发现是GET——可能源于表单漏写method属性、fetch配置被中间件覆盖、或重定向后方法被降级。

看响应头里的Allow字段说了什么

仍在刚才那个405请求的Headers面板中,向下滚动到Response Headers区域,找【Allow】字段。

若显示Allow: GET, HEAD,说明服务器压根没注册POST处理逻辑;若该字段空白或根本没出现,问题不在后端路由,而大概率出在Nginx/Apache配置、CDN策略或WebDAV模块干扰上。

快速验证前端代码是否写错

方法一:检查HTML表单method属性是否写错
确认

标签里写了method="POST"而不是method="post"(大小写敏感)或漏写method导致浏览器默认用GET。

方法二:检查JavaScript中fetch调用
fetch(url, { method: 'POST', body: JSON.stringify(data) })必须同时加headers: { 'Content-Type': 'application/json' },否则部分网关会因类型缺失直接返回405而非400。

方法三:留意隐藏的预检请求(OPTIONS)
跨域POST/PUT带Authorization等自定义header时,浏览器必先发OPTIONS。如果Network里第一个请求是OPTIONS 405、第二个灰掉不执行,说明实际业务请求根本没发出去——此时要查CORS配置或Nginx是否拦截了OPTIONS。

Mercor
Mercor

Mercor是一个革命性的AI招聘平台

下载

查后端路由是否注册了对应方法

第一步:如果是Express,确认是否写了app.post('/endpoint', ...),而不是只写了app.get('/endpoint', ...)或app.all('/endpoint', ...)却没过滤method。

第二步:如果是Django,检查urls.py是否绑定到仅支持GET的View类,或函数视图是否漏写request.method == 'POST'判断,又或错误使用了@require_GET装饰器。

第三步:如果是Spring Boot,确认是否用了@GetMapping("/user")这种只认GET的注解,应改为@PostMapping("/user")或@RequestMapping(value = "/user", method = RequestMethod.POST)。

【关键前提】服务器配置比代码逻辑优先级更高——Nginx若在location块里写了limit_except GET { deny all; },哪怕后端代码支持POST,请求也到不了应用层。

紧急绕过Nginx的405(仅限静态资源场景)

第一步:登录服务器,用nano或vim编辑对应站点的Nginx配置文件,通常路径为/etc/nginx/conf.d/your-site.conf或/etc/nginx/sites-enabled/default

第二步:在server块内的location / { … }段落中,插入一行:error_page 405 =200 $request_uri;

第三步:保存退出,执行nginx -t验证语法→无报错则运行systemctl reload nginx生效

【注意:此操作仅适用于纯静态HTML/CSS/JS资源被误判为不支持POST的场景,绝不可用于真实API接口,否则会掩盖真正的路由缺陷】

大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

405 not allowed

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
硬盘接口类型介绍
硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍:1、IDE接口是一种并行接口,主要用于连接硬盘和光驱等设备,它主要有两种类型:ATA和ATAPI,IDE接口已经逐渐被SATA接口;2、SATA接口是一种串行接口,相较于IDE接口,它具有更高的传输速度、更低的功耗和更小的体积;3、SCSI接口等等。

2023.10.19

2768

3

PHP接口编写教程
PHP接口编写教程

本专题整合了PHP接口编写教程,阅读专题下面的文章了解更多详细内容。

2025.10.17

2145

12

php8.4实现接口限流的教程
php8.4实现接口限流的教程

PHP8.4本身不内置限流功能,需借助Redis(令牌桶)或Swoole(漏桶)实现;文件锁因I/O瓶颈、无跨机共享、秒级精度等缺陷不适用高并发场景。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2025.12.29

3364

9

java接口相关教程
java接口相关教程

本专题整合了java接口相关内容,阅读专题下面的文章了解更多详细内容。

2026.01.19

160

15

墨刀AI提示词教学
墨刀AI提示词教学

本合集由PHP中文网精心整理,为您提供全面的墨刀AI提示词教学。内容涵盖高质量原型撰写公式与实操窍门,助您轻松掌握AI设计工具。无论是零基础入门还是进阶技巧,都能让您快速上手,大幅提升产品设计与协作效率。

2026.08.04

10

21

墨刀AI完整入门
墨刀AI完整入门

PHP中文网为您倾力打造墨刀AI保姆级入门指南完整版!本合集从零基础讲起,涵盖AI生成原型、提示词优化、图片转原型及多轮对话等核心功能。无论您是新手还是进阶用户,都能轻松掌握产品设计全流程。快来PHP中文网,一键解锁高效设计技巧,让想法即刻成型!

2026.08.04

8

20

墨刀AI进阶技巧
墨刀AI进阶技巧

本合集由PHP中文网精心整理,为您提供墨刀AI核心进阶策略指南。内容涵盖高效提示词写作、原型智能生成与微调、结构化导图制作及行业分析报告输出等实战技巧。助您轻松掌握AI设计工具,大幅提升产品设计与团队协作效率。

2026.08.04

10

14

火山引擎实名认证失败怎么办
火山引擎实名认证失败怎么办

火山引擎实名认证失败可能与证件信息填写错误、姓名或企业信息不一致、证件照片不清晰、营业执照状态异常、手机号验证失败或审核资料不完整有关。本专题整理个人认证、企业认证、资料上传、审核退回、重新提交和认证不通过的常见处理方法。

2026.08.04

5

10

火山引擎域名备案流程详解
火山引擎域名备案流程详解

火山引擎域名备案适合需要在火山引擎云服务器、对象存储、CDN或网站服务上绑定域名的用户参考。本专题整理备案入口、账号实名认证、备案类型选择、主体信息填写、网站信息提交、资料上传、初审核验、管局审核和备案失败排查,帮助用户完成网站上线前的备案流程。

2026.08.04

1

10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.4万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 131.8万人学习