更新Gradle Properties后出现Java URI语法异常，求解决方案

问题核心 #

异常中的URISyntaxException: Illegal character in path明确指向路径存在非法字符，主要触发场景为：

• 项目本地存储路径包含中文、空格或特殊符号（如!@#$等）
• gradle-wrapper.properties配置文件里的distributionUrl格式错误或包含特殊字符

修复步骤 #

• 修正项目存储路径
  将项目移到全英文、无特殊符号的路径下，比如把D:\我的Flutter项目\test_app改为D:\Flutter_Projects\test_app。

• 修复Gradle Wrapper配置

  1. 打开项目内的android/gradle/wrapper/gradle-wrapper.properties文件
  2. 找到distributionUrl行，确保格式正确，示例：

     distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-all.zip
     

  3. 检查该行是否存在多余空格、乱码或错误修改，若不确定正确值，可参考全新Flutter项目的对应配置。

• 清理缓存后重新构建
  依次执行以下命令：

  flutter clean
  flutter pub get
  cd android
  ./gradlew clean
  cd ..
  flutter run
  

新手提示 #

修改Gradle相关配置时，仅改动官方文档明确说明的项，避免随意修改gradle-wrapper.properties这类核心配置，减少版本或路径兼容问题。

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