Python调用playsound库报错259无法播放wav音频 指定路径触发unicode错误

1. 绝对路径Unicode报错修复 #

• 该错误由Windows路径的反斜杠转义字符冲突导致，解决方案可选以下任意一种：
  • 路径字符串前加r标识为原始字符串：

    from playsound import playsound
    playsound(r'C:\完整路径\alarm.wav')
    

  • 将路径中的反斜杠替换为正斜杠：playsound('C:/完整路径/alarm.wav')
  • 对反斜杠进行二次转义：playsound('C:\\完整路径\\alarm.wav')

2. Error 259播放报错修复 #

先使用修正后的绝对路径重新测试，若仍然报错按以下顺序排查：

• 检查音频编码兼容性：部分后缀为wav的文件实际采用非标准编码参数，可将音频重新转码为16位、44100Hz采样率的标准PCM编码WAV格式，Windows原生MCI接口对非标准参数兼容性极差。
• 检查playsound版本：Windows平台优先使用1.2.2版本，高版本存在已知兼容性缺陷，执行以下命令重装指定版本：

  pip uninstall playsound
  pip install playsound==1.2.2
  

• 检查声卡驱动：同代码在其他设备可正常运行，大概率是当前设备的音频驱动版本不兼容MCI接口，更新声卡驱动后重启设备重试。
• 兼容替代方案：若上述操作均无效，可替换为稳定性更高的pygame库实现播放功能，示例代码：

  import pygame
  pygame.mixer.init()
  pygame.mixer.music.load(r'C:\完整路径\alarm.wav')
  pygame.mixer.music.play()
  # 等待播放完成
  while pygame.mixer.music.get_busy():
      pygame.time.Clock().tick(10)
  

3. 多线程调用注意事项 #

playsound在Windows平台不具备线程安全性，多线程调用时需要加锁，避免并发调用导致的偶发报错。

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