Flutter用audioplayers报错：NoSuchMethodError: play调用在null对象上

嘿，你遇到的这个错误原因很明确：你只声明了AudioCache cache变量，但没有初始化它的实例，所以当你调用cache.play()的时候，cache还是null，自然会抛出“play方法被调用在null对象上”的错误。

下面给你具体的修复步骤和代码示例：

第一步：初始化AudioCache实例 #

你需要先创建AudioCache的实例，而不是只声明变量。这里有两种常用的初始化方式：

方式1：声明时直接初始化 #

AudioCache cache = AudioCache(); // 直接完成初始化，无需等待生命周期
AudioPlayer? player; // 用可空类型让代码更安全

方式2：在initState里初始化（适合StatefulWidget） #

如果你的组件是StatefulWidget，在initState方法里初始化更规范：

late AudioCache cache; // 用late关键字标记延迟初始化
AudioPlayer? player;

@override
void initState() {
  super.initState();
  cache = AudioCache(); // 在组件初始化时完成cache实例创建
}

第二步：修正按钮的点击逻辑 #

初始化cache之后，调用cache.play()就不会有null错误了。另外可以给播放逻辑加上错误捕获，方便排查音频路径等其他问题：

// 播放按钮
InkWell(
  onTap: () async {
    try {
      player = await cache.play('audio/blind.mp3');
      print('音频开始播放');
    } catch (e) {
      print('播放出错：$e'); // 捕获路径错误等其他问题
    }
  },
  child: const Text('播放'),
),

// 停止按钮
InkWell(
  onTap: () async {
    await player?.stop();
    print('音频已停止');
    player = null; // 可选：停止后清空player实例，避免重复操作
  },
  child: const Text('停止'),
),

额外注意事项 #

别忘了检查你的pubspec.yaml是否正确配置了音频资源，否则即使初始化了cache，也会找不到音频文件：

flutter:
  assets:
    - audio/blind.mp3 # 确保路径和你代码里的完全一致

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