移动端网页 fetch 请求为何报错 invalid token 'xyz' in CORS header
服务器返回的 Access-Control-Allow-Methods 头部包含无效的 HTTP 方法名称会导致移动端 fetch 请求失败。
检查响应头中的 Access-Control-Allow-Methods 字段
移动端网页发起跨域请求时,服务器返回的响应头中包含 Access-Control-Allow-Methods 字段。该字段用于告知客户端支持哪些 HTTP 请求方法。如果该字段的值中包含无效或未知的 HTTP 方法名称,浏览器会报错。错误信息通常显示为 Reason: invalid token 'xxx' in CORS header 'Access-Control-Allow-Methods'。这表明服务器配置错误,发送了不被客户端识别的方法名。
排查时需在浏览器开发者工具的 Network 面板中查看该响应的 Headers。找到 Access-Control-Allow-Methods 这一行,检查其值是否为逗号分隔的有效 HTTP 方法列表。常见的有效方法包括 GET、POST、HEAD 等。如果发现列表中存在非标准方法或拼写错误,即为问题所在。该错误通常只能通过修改服务器配置来解决。
确认 HTTP 方法名称是否为标准且有效
Access-Control-Allow-Methods 头部的值是一个逗号分隔的字符串,包含服务器允许的 HTTP 方法。如果字符串中包含无效的 token,例如 'xyz',客户端用户代理将无法识别。这会导致 CORS 请求失败。服务器必须确保发送的每一个方法名称都是标准 HTTP 方法。非标准方法可能导致客户端拒绝处理该响应。
操作步骤是打开浏览器的开发者工具,切换到 Network 标签页,找到失败的请求。点击该请求,在右侧面板查看 Response Headers。定位 Access-Control-Allow-Methods。确认其中列出的每一个方法名称都是有效的。例如,确保没有拼写错误或使用了非标准的 HTTP 动词。修正服务器配置后,重新发起请求即可验证结果。
排查客户端 HTTP 库或用户代理版本问题
虽然该错误主要由服务器配置引起,但客户端使用的 HTTP 库或用户代理版本过旧也可能导致无法识别某些方法。如果服务器配置正确,但客户端仍报错,可能需要更新客户端代码或浏览器。MDN 文档建议检查客户端的 HTTP 库是否为最新版本。过时的库可能不支持某些新的或特定的 HTTP 方法。
在移动端开发中,检查使用的 HTTP 请求库(如 Axios、Fetch API 封装等)是否为最新版本。同时确认使用的浏览器或 WebView 版本是否支持最新的 HTTP 规范。如果确认客户端已更新但仍报错,则问题依然出在服务器端的 Access-Control-Allow-Methods 配置上。确保服务器发送的方法列表与客户端支持的方法列表一致。
验证修复后的请求是否成功
在修正服务器配置,移除 Access-Control-Allow-Methods 头部中的无效方法名称后,需要重新测试请求。刷新移动端网页,再次触发该跨域请求。在开发者工具的 Network 面板中观察该请求的状态。如果配置正确,请求应该能够成功完成,不再出现 CORS 相关的错误提示。
验证结果的方法是查看请求的 Status Code 是否为 200 或其他成功的状态码。同时检查响应头中是否正确包含了 Access-Control-Allow-Origin 等必要的 CORS 头部。如果请求成功,说明无效 token 问题已解决。如果仍然报错,请再次检查服务器配置,确保没有遗漏其他无效的方法名称。
资料与延伸阅读
你可以通过以下原始资料核对文中概念,并继续深入阅读。