Google Drive OAuth PHP授权回调报Not Acceptable错误解决方法
Google Drive API OAuth回调「Not Acceptable」通用适配方案
报错核心原因
该错误由服务器端WAF/ModSecurity规则触发:Google OAuth默认以GET请求回传授权码,回调URL查询参数中携带的百分号编码scope值、长格式授权码,会被安全规则误判为SQL注入、XSS类攻击请求,直接拦截返回406(Not Acceptable)状态码。
零全局服务器配置的解决方法
方案1:启用Google官方支持的form_post回传模式
这是Google OAuth2规范原生支持的回调方式,无需调整服务器全局配置,从请求层面规避WAF对GET参数的检测:
- 调整初始化
Google_Client的代码,新增授权请求参数配置:
$client = new Google_Client(); $client->setApplicationName('Google Drive API PHP Quickstart'); $client->setRedirectUri("https://example.com/google_redirect"); $client->setClientId("my-client-id"); $client->setClientSecret("my-client-secret"); $client->setScopes(Google_Service_Drive::DRIVE); $client->setAccessType('offline'); $client->setPrompt('select_account consent'); // 新增官方原生参数,开启POST表单回传 $client->addAuthorizationParameters([ 'response_mode' => 'form_post' ]);
- 调整后的授权流程:Google完成身份校验后,会以POST方法提交所有授权参数到预设的回调地址,URL查询参数中不会携带
code、scope等敏感字段,从根源上避开基于URL参数的拦截规则。 - 回调处理逻辑适配:直接从POST请求体读取授权码即可:
// 回调页面处理代码 $code = $_POST['code'] ?? ''; $accessToken = $client->fetchAccessTokenWithAuthCode($code);
方案2:单路径安全规则豁免
不需要修改全局ModSecurity/WAF配置,仅对/google_redirect这个独立回调路径添加规则豁免,部署成本极低,不影响站点其他接口的安全检测:
- Apache站点配置(仅对该路径生效):
<Location "/google_redirect"> # 仅移除触发拦截的规则ID,不全局关闭安全检测 SecRuleRemoveById 949110 </Location>
- Nginx站点配置:在该路径对应的location块中添加WAF规则跳过配置即可。
效果验证
配置完成后重新走授权流程:
- 若使用
form_post模式,回调请求会以POST方法到达,浏览器地址栏不会携带长串授权参数 - 回调页可正常读取授权码,完成后续Drive接口的权限校验,不会返回406错误
内容的提问来源于stack exchange,提问作者Encrypted
相关产品推荐
相关产品推荐

