Flutter Web 跨域（CORS）问题本地调试解决方案

Flutter Web 跨域（CORS）问题解决方案

在 Flutter Web 开发过程中，默认情况下浏览器会遵循同源策略。当你的应用尝试加载不同域名的网络资源（如 API 接口、图片等）时，经常会遇到 CORS（跨域资源共享） 错误，导致请求失败。

虽然生产环境应由后端配置 CORS 头来解决，但在本地开发和调试阶段，我们可以通过修改 Flutter 工具链源码来临时禁用浏览器的安全策略，从而顺利调试。

以下是详细的操作步骤：

---

🛠️ 操作步骤

第一步：定位 chrome.dart 文件

首先，你需要找到 Flutter SDK 中负责启动 Chrome 浏览器的配置文件 chrome.dart。

参考路径（请根据你的实际安装路径调整）：

<你的 Flutter 安装目录>\packages\flutter_tools\lib\src\web\chrome.dart 

示例：E:\app\flutter-sdk\flutter_flutter\packages\flutter_tools\lib\src\web

第二步：修改源码以禁用安全策略

打开 chrome.dart 文件，找到构建 Chrome 启动参数（arguments）的地方。通常在 _findChromeArgs 或类似的方法中。

在参数列表中添加 '--disable-web-security' 标志。

修改代码示意：

// 在 arguments 列表中添加以下行
'--disable-web-security',

⚠️ 注意：此操作会禁用浏览器的同源策略，仅建议在本地开发调试时使用，切勿将此类配置打包发布到生产环境。

第三步：清除 Flutter 缓存

修改完 SDK 源码后，Flutter 可能会继续使用旧的编译缓存。为了让修改生效，必须删除相关的缓存文件。

• 需要删除的文件：
  1. flutter_tools.snapshot
  2. flutter_tools.stamp

缓存目录参考路径：

<你的 Flutter 安装目录>\bin\cache 

示例：E:\app\flutter-sdk\flutter_flutter\bin\cache

删除这两个文件后，下次运行 Flutter 命令时会自动重新编译工具链。

第四步：重新运行项目

完成上述步骤后，回到你的项目根目录，执行以下命令验证环境并重新启动项目：

flutter doctor -v
flutter run -d chrome

此时，Chrome 浏览器应以禁用安全策略的模式启动，你的 Web 应用应该可以正常加载跨域资源了。

---

💡 重要提示

1. 安全性警告：--disable-web-security 会让浏览器完全暴露于跨站脚本攻击（XSS）等风险中。请务必只在开发机器上使用，且不要在该模式下登录敏感账户或进行金融操作。
2. 生产环境方案：正式上线时，请务必联系后端开发人员，在服务器响应头中正确配置 Access-Control-Allow-Origin 等 CORS 相关字段，而不是依赖前端禁用安全策略。
3. 版本更新影响：当你升级 Flutter SDK 版本时，chrome.dart 文件可能会被重置，届时需要重新执行上述'第二步'和'第三步'。

通过以上步骤，你可以轻松绕过本地开发时的跨域限制，提升 Flutter Web 的开发效率！