Flutter pub get拉取GitLab多包仓库依赖时触发相对路径报错

触发报错的源头不在你项目的pubspec配置，而在你fork的twilio_programmable_video主包自身的pubspec.yaml文件：为了适配mono-repo本地开发场景，主包是通过../programmable_video_platform_interface的本地相对路径，依赖同仓库下的接口包的。
这种相对路径依赖仅在本地仓库目录结构下能正常解析，一旦通过git方式把主包拉取到pub的全局缓存目录，相对路径的跳转逻辑就会完全失效，触发pub的合法性校验，直接抛出路径无效的错误。哪怕你在自己项目里单独通过dependencies或者dependency_overrides声明两个包的git源，只要主包自带的这个相对路径依赖没被处理，报错就会持续存在。

方案1：修改fork仓库内的主包依赖配置（长期使用最稳定） #

1. 打开你fork的远程仓库，进入programmable_video目录（也就是主包的根目录），找到里面的pubspec.yaml
2. 把文件中原先写的本地相对路径依赖：

   twilio_programmable_video_platform_interface:
     path: ../programmable_video_platform_interface
   

   替换成匹配你fork仓库地址的git依赖配置：

   twilio_programmable_video_platform_interface:
     git:
       url: ssh://git@gitlab.com/myname/programmable-video.git
       ref: master
       path: programmable_video_platform_interface
   

3. 把修改提交到你fork仓库的master分支
4. 回到你的业务项目，只需要在dependencies里声明主包的git拉取源即可，不需要单独再声明接口包的依赖，直接执行flutter pub get就能正常完成解析。

方案2：本地克隆仓库做路径绑定（临时调试最方便） #

1. 把你fork的整个仓库克隆到本地磁盘的固定目录，比如存放在~/code/programmable-video
2. 在你业务项目的dependency_overrides块里，直接用本地路径绑定两个包的位置，绕过git拉取时的路径校验：

   dependency_overrides:
     twilio_programmable_video_platform_interface:
       path: ~/code/programmable-video/programmable_video_platform_interface
     twilio_programmable_video:
       path: ~/code/programmable-video/programmable_video
   

3. 执行flutter pub get即可正常拉取依赖，后续需要同步fork仓库的更新时，直接在本地仓库目录执行git pull，再重新跑一次flutter pub get就行。

• 不要同时给同一个包配置git拉取源和本地路径两种依赖方式，否则会触发pub的版本冲突校验失败
• 如果用方案1，要确认配置里的仓库路径、分支名和你fork仓库的实际结构完全匹配，避免因为路径拼写错误导致拉取失败
• 这类mono-repo结构的Dart包，只要包内部还保留本地开发用的相对路径依赖，远程通过git拉取时就必然会触发这类路径校验问题，和pub的版本没有直接关系

内容的提问来源于stack exchange，提问作者yukitaka13