Flutter点击IconButton后UI卡顿，设备端读取MP3文件异常

1. 适配Android 11分区存储权限 #

Android 11采用分区存储机制，和Android 13的权限逻辑存在差异，需针对性调整：

• 在AndroidManifest.xml中添加android:requestLegacyExternalStorage="true"（适用于targetSdk ≤30的情况），如果你的应用targetSdk为31+，需申请MANAGE_EXTERNAL_STORAGE权限，但音乐播放器场景更推荐对Android13+用READ_MEDIA_AUDIO，Android11及以下用READ_EXTERNAL_STORAGE。
• 动态权限请求需适配系统版本：

  if (Platform.isAndroid) {
    final permission = await Permission.storage.request();
    if (!permission.isGranted) {
      // 提示用户前往设置开启权限
      return;
    }
  }
  

2. 避免主线程阻塞（核心卡顿原因） #

读取大量MP3文件属于耗时操作，直接在IconButton点击事件中同步执行会阻塞UI线程，导致按钮无响应，必须将逻辑移至后台：

• 使用compute函数将扫描任务隔离到后台线程：

  IconButton(
    icon: const Icon(Icons.music_note),
    onPressed: () async {
      if (!await Permission.storage.isGranted) return;
      final downloadPath = await getDownloadPath();
      // 后台执行扫描逻辑
      final mp3Files = await compute(_scanMp3Files, downloadPath);
      // 拿到结果后再跳转页面
      if (mounted) {
        Navigator.push(context, MaterialPageRoute(builder: (_) => MusicListScreen(files: mp3Files)));
      }
    },
  )
  
  // 必须是顶层或static函数，供compute调用
  List<String> _scanMp3Files(String path) {
    final paths = <String>[];
    final dir = Directory(path);
    if (dir.existsSync()) {
      final entities = dir.listSync(recursive: true);
      for (final entity in entities) {
        if (entity is File && entity.path.endsWith('.mp3')) {
          paths.add(entity.path);
        }
      }
    }
    return paths;
  }
  

• 或者改用异步遍历，避免同步阻塞：

  Future<List<String>> _scanMp3FilesAsync(String path) async {
    final paths = <String>[];
    final dir = Directory(path);
    if (await dir.exists()) {
      await for (final entity in dir.list(recursive: true)) {
        if (entity is File && entity.path.endsWith('.mp3')) {
          paths.add(entity.path);
        }
      }
    }
    return paths;
  }
  

3. 正确获取下载文件夹路径 #

不要硬编码路径，用path_provider库适配不同版本的存储路径：

import 'package:path_provider/path_provider.dart';

Future<String> getDownloadPath() async {
  Directory? dir;
  if (Platform.isAndroid) {
    final dirs = await getExternalStorageDirectories(type: StorageDirectory.downloads);
    dir = dirs?.first;
  }
  return dir?.path ?? '';
}

4. 调试技巧 #

• 在Android11设备开启开发者选项中的严格模式，能检测主线程耗时操作并弹出警告，快速定位阻塞点。
• 在文件扫描逻辑中添加日志打印，确认是权限问题导致读取失败，还是遍历文件耗时过长。

内容的提问来源于stack exchange，提问作者Dimuth De Zoysa