新电脑装Android Studio后运行Flutter项目遇Gradle网络错误

问题描述 #

新电脑安装Android Studio后，运行Flutter默认示例项目时触发Gradle相关Java错误。已尝试在虚拟设备及开启USB调试的物理设备上运行，问题均未解决。

错误截图：

项目主文件代码：

import 'package:flutter/material.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  // This widget is the root of your application.
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const MyHomePage(title: 'Flutter Demo Home Page'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});

  final String title;

  @override
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  int _counter = 0;

  void _incrementCounter() {
    setState(() {
      _counter++;
    });
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Theme.of(context).colorScheme.inversePrimary,
        title: Text(widget.title),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            const Text(
              'You have pushed the button this many times:',
            ),
            Text(
              '$_counter',
              style: Theme.of(context).textTheme.headlineMedium,
            ),
          ],
        ),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: _incrementCounter,
        tooltip: 'Increment',
        child: const Icon(Icons.add),
      ), // This trailing comma makes auto-formatting nicer for build methods.
    );
  }
}

环境信息：

• Android Studio安装在F盘
• Flutter和Gradle安装在C盘

解决建议 #

1. 核对JDK配置 #

• 打开Android Studio，进入File > Project Structure > SDK Location，确认JDK路径为Android Studio自带版本（推荐使用，避免版本兼容问题）。
• 配置系统环境变量JAVA_HOME，指向上述JDK目录，确保Gradle能正常识别Java环境。

2. 清理Gradle缓存 #

• 删除以下目录的缓存文件：
  • C盘用户目录下的.gradle/caches文件夹
  • 项目根目录下的.gradle文件夹
• 执行命令行操作：

  flutter clean
  flutter pub get
  

• 完成后重新尝试构建项目。

3. 匹配Gradle版本 #

• 打开项目android/build.gradle文件，确认classpath 'com.android.tools.build:gradle:x.x.x'的版本与Android Studio兼容，建议使用稳定版（如7.4.2）。
• 打开android/gradle/wrapper/gradle-wrapper.properties，检查distributionUrl指向的Gradle版本是否与classpath版本匹配。

4. 检查权限与路径 #

• 确保Android Studio、Flutter、Gradle所在目录拥有读写权限，避免因权限不足导致Gradle运行失败。
• 确认所有相关目录路径无中文、空格或特殊字符。

5. 重新同步Gradle #

• 在Android Studio右上角点击Sync Project with Gradle Files按钮，等待同步完成后再运行项目。

内容的提问来源于stack exchange，提问作者Vin. T