跨域请求出现405错误怎么办_PHP处理预检请求问题排查【故障排查】

1次阅读

options请求返回405是因为服务端未正确处理预检请求,php默认不响应、web服务器未配置路由或cors头、框架中间件跳过options、或nginx/apache提前拦截所致。

跨域请求出现405错误怎么办_PHP处理预检请求问题排查【故障排查】

为什么 OPTIONS 请求返回 405?

405 错误出现在浏览器发起跨域请求时的预检阶段,本质是服务端拒绝了 OPTIONS 方法。PHP 默认不处理 OPTIONS 请求,Apache/Nginx 也通常未配置对应路由或响应头,导致服务器直接返回 405 Method Not Allowed。

常见诱因包括:

  • PHP 脚本未显式响应 OPTIONS 请求(比如只写了 if ($_SERVER['REQUEST_METHOD'] === 'POST')
  • Nginx/Apache 没有为 OPTIONS 设置 200 状态码和必要 CORS 头
  • PHP-FPM 或 Web 服务器拦截了 OPTIONS,未转发给 PHP
  • 某些框架(如 laravelthinkphp)的中间件或路由规则默认跳过 OPTIONS

PHP 中如何正确响应预检请求

必须在入口脚本(如 index.php)或全局中间件中提前拦截 OPTIONS 并立即返回,不能走后续业务逻辑。

最小可行代码示例:

立即学习PHP免费学习笔记(深入)”;

if ($_SERVER['REQUEST_METHOD'] === 'OPTIONS') {     header('access-Control-Allow-Origin: https://your-frontend.com');     header('Access-Control-Allow-Methods: GET, POST, PUT, DELETE, OPTIONS');     header('Access-Control-Allow-Headers: Content-Type, Authorization, X-Requested-With');     header('Access-Control-Allow-Credentials: true');     header('Access-Control-Max-Age: 86400');     exit(0); }

注意要点:

  • Access-Control-Allow-Origin 不能设为 * 同时又开启 Access-Control-Allow-Credentials: true
  • Access-Control-Allow-Headers 必须包含前端实际发送的自定义头(如 Authorization
  • 务必调用 exit()die(),避免后续代码执行
  • 如果使用 $_SERVER['HTTP_ORIGIN'] 动态设置来源,需先校验白名单,防止通配

Nginx 和 Apache 的预检配置补漏

即使 PHP 层写了 OPTIONS 响应,Web 服务器仍可能提前拦截。需确认是否被 rewrite 规则或安全模块阻断。

Nginx 推荐配置(放在 location 块内):

if ($request_method = 'OPTIONS') {     add_header Access-Control-Allow-Origin "https://your-frontend.com";     add_header Access-Control-Allow-Methods "GET, POST, PUT, DELETE, OPTIONS";     add_header Access-Control-Allow-Headers "Content-Type, Authorization, X-Requested-With";     add_header Access-Control-Allow-Credentials "true";     add_header Access-Control-Max-Age "86400";     add_header Content-Length 0;     add_header Content-Type text/plain;     return 204; }

Apache 需确保启用了 mod_headersmod_rewrite,并在 .htaccess 或虚拟主机配置中加入:

RewriteEngine On RewriteCond %{REQUEST_METHOD} OPTIONS RewriteRule ^(.*)$ $1 [R=200,L]

然后配合 Header set 指令添加 CORS 头 —— 单靠 Header always set 不足以覆盖预检场景。

调试时容易忽略的细节

405 故障常卡在“以为 PHP 搞定了,其实 Web 服务器没放行”。排查顺序建议从外到内:

  • curl -X OPTIONS -I http://your-api.com/xxx 直接测试,看响应头和状态码是否来自 PHP 还是 Web 服务器
  • 检查 Nginx Error log 是否有 rewrite or internal redirection cycle 类报错
  • 确认 PHP 的 getallheaders() 在 CLI 模式下不可用,但预检请求中 $_SERVER['REQUEST_METHOD'] 是可靠的
  • 某些 CDN(如 Cloudflare)会缓存 OPTIONS 响应,临时关闭缓存再试
  • 如果 API 路由带版本前缀(如 /v1/users),确保所有层级都覆盖了 OPTIONS 处理逻辑

最麻烦的情况是:Nginx 把 OPTIONS 当作静态资源请求,匹配到了 try_files 规则并返回了 405 —— 这时候得在 location 块里单独处理方法判断,而不是依赖后端兜底。

text=ZqhQzanResources