移动端 fetch 请求报错 CORS request did not succeed 怎么排查

检查网络层错误类型

在移动端浏览器中打开开发者工具并切换到 Network 面板，查看具体的失败原因。常见的错误包括 DNS 解析失败、连接超时、连接被拒绝或 TLS 握手错误。这些错误表明 HTTP 连接在协议或网络层面失败，而非单纯的跨域策略问题。确认请求是否成功建立连接是排查的第一步。

如果网络面板显示请求未发出或立即失败，可能是移动网络环境或设备防火墙导致。尝试切换网络环境或关闭移动设备的防火墙设置，观察请求是否能正常发出。排除网络层面的干扰后，再确认是否为浏览器插件或隐私保护工具拦截了请求。

移动端浏览器通常也支持扩展插件，广告拦截器或隐私保护工具可能会错误地拦截跨域请求。尝试在浏览器设置中禁用所有扩展插件，或者使用无痕/隐私浏览模式重新加载页面。如果请求在无痕模式下成功，说明是插件或隐私工具导致的问题。

某些隐私工具会修改请求头或阻止特定类型的网络连接。在确认插件干扰后，需要找到具体拦截请求的插件并调整其规则，或者选择不使用该插件。确保浏览器环境不会主动阻断 fetch 请求的建立。此外，检查是否开启了浏览器的安全增强功能，这些功能有时会限制跨域请求的发起。

如果页面通过 HTTPS 加载，但请求的目标资源使用 HTTP 协议，浏览器会阻止该请求。确保所有 API 接口和资源都通过 HTTPS 协议提供服务，避免混合内容导致的请求失败。同时检查目标服务器的 SSL/TLS 证书是否有效，过期或无效的证书会导致握手失败。

在移动端设备上，证书验证可能更加严格。如果服务器证书不受信任或配置错误，请求会在 TLS 握手阶段失败。确认服务器正确配置了证书，并确保移动设备信任该证书颁发机构。对于本地开发环境，确保使用正确的协议和端口，并验证服务是否正常运行。

服务器必须正确响应请求，包括返回有效的 HTTP 状态码和响应体。即使预检请求（OPTIONS）成功，如果实际请求未返回数据，也会导致 fetch 失败。检查服务器日志，确认请求是否到达并处理，以及是否因异常导致未返回响应。

在开发环境中，确保本地服务已启动并监听正确的端口。如果服务未响应或返回错误状态码，需要修复服务端逻辑。此外，注意浏览器是否处于隐私浏览模式，某些隐私模式的安全策略可能会限制跨域请求的执行。确认服务器端点配置正确，并能够返回预期的响应数据。