核心背景梳理 #

先明确两个关键组件的核心行为：

• Flutter Pub缓存（PUB_CACHE）：默认存放在用户目录下的.pub-cache，用来缓存下载的Flutter/Dart插件、依赖包。当你添加url_launcher: ^6.0.20后，Pub会把插件的Android端代码缓存到这个目录，再在项目的Android构建配置文件（比如.android/.flutter-plugins）里写入插件的本地路径引用。
• Gradle路径验证逻辑：Gradle在创建构建任务（比如编译插件代码、合并资源的任务）时，会严格校验任务涉及的文件路径的根目录一致性。它要求任务关联的所有文件必须处于可识别的统一根路径下，否则就会抛出Could not create task 'xxx'. this and base files have different roots错误。

原路径导致构建失败的原因 #

你的原始PUB_CACHE路径大概率存在两个问题：

1. 包含特殊字符/非ASCII编码：比如用户目录是中文名称，或者路径里有空格、特殊符号。Gradle对路径字符串的解析依赖ASCII编码，特殊字符会导致路径解析异常，让Gradle误判插件文件的根目录和项目根目录不属于同一体系。
2. 跨文件系统根：如果PUB_CACHE在另一个磁盘分区（比如项目在D盘，缓存在C盘），Gradle会认为这两个路径属于不同的文件系统根，无法为跨根的文件创建关联任务，直接触发报错。

而url_launcher的Android模块包含较多涉及系统权限、Intent处理的任务，这些任务对路径的敏感度更高，所以比其他插件更容易触发这个校验失败。

修改PUB_CACHE到项目根目录的解决逻辑 #

把PUB_CACHE指向项目根目录下的无特殊字符文件夹后，解决了两个核心问题：

• 统一根目录：插件缓存路径和项目根目录处于同一个文件系统根（甚至同一目录下），Gradle解析时能识别到两者属于同一路径体系，不会触发根目录不一致的校验错误。
• 消除路径编码问题：无特殊字符的纯ASCII路径让Gradle能正确解析路径字符串，避免了因编码异常导致的路径误判。
• 环境变量生效：重启系统后，Flutter和Gradle都能正确读取新的PUB_CACHE配置，所有插件的缓存、引用路径都统一到了项目相关的路径下，构建时的路径校验自然通过。

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