用 Melos 解决 Flutter Monorepo 的依赖冲突：一个真实案例

在 Flutter 项目开发中，尤其是采用 Monorepo 架构管理多个相互关联的包时，依赖冲突是一个常见且令人头疼的问题。不同的包可能依赖同一个库的不同版本，导致项目无法编译或运行时出现难以调试的错误。

本文将基于一个 真实的 Flutter Monorepo 项目案例，演示如何使用 Melos 自动检测和解决依赖冲突，显著提升开发效率。

1. 问题场景：Dio 版本冲突

假设我们有一个 Flutter Monorepo 项目，包含以下 3 个包：

1. core_utils（基础工具包）
   • 依赖 dio: ^5.0.0（最新稳定版）。
2. auth_service（身份验证服务包）
   • 依赖 dio: ^4.0.0（旧版本）。
3. main_app（主应用）
   • 同时依赖 core_utils 和 auth_service。

当运行 flutter pub get 时，Dart 的依赖解析器会发现 dio 的版本要求冲突，导致报错：

Because core_utils depends on dio ^5.0.0 and auth_service depends on dio ^4.0.0, version solving failed.

传统解决方案：

• 手动检查每个包的 pubspec.yaml，尝试调整 dio 版本。
• 反复运行 flutter pub get 测试兼容性。
• 可能耗费 10-30 分钟，甚至引入新问题。

2. Melos 的自动化解决方案

Melos 提供了一套完整的工具链，可以 自动检测依赖冲突，并 推荐或执行修复方案。

步骤 1：使用 melos bootstrap 检测冲突

在项目根目录运行：

melos bootstrap

Melos 会执行以下操作：

1. 扫描所有包的 pubspec.yaml，识别出 core_utils 和 auth_service 的 dio 版本不兼容。
2. 输出清晰的冲突报告（示例）：

[MELOS] ⚠️  Dependency conflict detected:
  - Package "core_utils" requires dio: ^5.0.0
  - Package "auth_service" requires dio: ^4.0.0
[MELOS] 💡 Suggested solution: Upgrade "auth_service" to use dio: ^5.0.0.

步骤 2：自动修复冲突

Melos 提供两种修复方式：

方案 1：自动升级依赖（推荐）

在 melos.yaml 中配置自动修复脚本：

scripts:
  fix_deps:
    run: melos exec --scope="auth_service" -- flutter pub add dio:"^5.0.0"
    description: "Force upgrade dio to ^5.0.0 in conflicting packages"

然后执行：

melos run fix_deps

效果：

• Melos 会自动修改 auth_service/pubspec.yaml，将 dio 升级到 ^5.0.0。
• 无需手动编辑文件，避免人为错误。

方案 2：依赖覆盖（临时方案）

如果某些包暂时无法升级，可以在主应用的 pubspec.yaml 中强制指定版本：

dependency_overrides:
  dio: ^5.0.0

注意：此方法可能掩盖潜在兼容性问题，建议仅作为临时措施。

步骤 3：验证解决

再次运行：

melos bootstrap

此时所有包均使用 dio: ^5.0.0，冲突解决，项目可正常编译。

3. 对比：Melos vs 手动解决

4. 最佳实践

1. 统一核心库版本
   • 在 melos.yaml 中定义共享依赖版本（如 dio、flutter_riverpod）。
2. CI 集成检查
   • 在 CI 流水线中加入依赖冲突检测：

     steps:
       - run: melos bootstrap
       - run: melos exec -- flutter pub outdated --mode=MAJOR
     

3. 定期同步依赖
   • 使用 melos run upgrade 定期更新所有包的依赖。

5. 总结

在 Flutter Monorepo 项目中，依赖冲突是不可避免的，但 Melos 可以将其从“手动噩梦”变成“自动化流水线”：
✅ 自动检测冲突，精准定位问题包。
✅ 一键修复，减少人为错误。
✅ 无缝集成 CI/CD，确保团队代码一致性。

如果你的项目正在面临依赖管理难题，现在就尝试 Melos，让开发效率飞升！ 🚀

延伸阅读：

• Melos 官方文档
• Flutter 依赖管理最佳实践