Flutter问题：flutter_sound包无法完成初始化

• 检查权限配置

  • Android：确认AndroidManifest.xml中添加了RECORD_AUDIO权限，Android 13及以上还需添加POST_NOTIFICATIONS；如果需要存储音频，还要加WRITE_EXTERNAL_STORAGE（Android 10+可改用MANAGE_EXTERNAL_STORAGE或使用媒体存储API）。
  • iOS：在Info.plist里添加NSMicrophoneUsageDescription字段，填写麦克风使用的说明文本（比如"需要麦克风权限进行音频录制"）。

• 验证版本兼容性

  • 核对pubspec.yaml中flutter_sound的版本与你的Flutter SDK版本是否匹配，可查看flutter_sound的官方文档确认支持的Flutter版本范围，不兼容的话尝试升级或降级包版本。

• 规范初始化时机

  • 不要在Widget的build方法中直接初始化FlutterSoundRecorder，建议在initState中先请求权限，获得权限后再初始化：

    late FlutterSoundRecorder _recorder;
    bool _hasPermission = false;
    
    @override
    void initState() {
      super.initState();
      _initRecorder();
    }
    
    Future<void> _initRecorder() async {
      _hasPermission = await FlutterSoundRecorder().hasPermission;
      if (_hasPermission) {
        _recorder = FlutterSoundRecorder();
        await _recorder.openRecorder();
      }
    }
    

• 检查平台特定配置

  • Android：确保build.gradle中的minSdkVersion不低于flutter_sound要求的版本（通常是21）；
  • iOS：打开Xcode检查项目权限设置，确认麦克风权限已启用，同时执行pod install --repo-update确保依赖正确安装。

• 查看完整错误日志

  • 除截图外，查看控制台输出的完整错误信息，原生层的错误提示（比如权限被拒绝、库加载失败）能更精准定位问题。

• 清理缓存重新构建

  • 执行flutter clean、flutter pub get后重新运行项目；iOS端可删除Pods文件夹和Podfile.lock，再执行pod install。

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