iOS开发中AudioServicesPlaySystemSounds与通知音效突然失效求助

问题概述 #

Swift开发的iOS应用所有音效完全无声，涵盖两类场景：

• AudioServicesPlaySystemSounds调用的系统音效
• 自定义.aiff格式的通知音效
  此前功能正常，突发故障无明确时间点，已尝试以下方案均无效：
• 确认设备非静音/专注模式、音量拉满
• 切换至AudioServicesPlaySystemSoundWithCompletion接口
• 通过MPVolumeView强制设置音量为1.0
• 尝试SpriteKit音效功能
• 重构为AVAudioPlayer(contentsOf: url)方案

核心排查与解决方向 #

1. 强制配置音频会话（优先级最高） #

iOS 16+后音频会话的默认逻辑有细节调整，即使之前未主动配置，系统更新可能导致原有默认行为失效。启动时主动初始化音频会话：

import AVFoundation

func setupAudioSession() {
    do {
        // .playback分类可绕过静音键（除非用户强制开启静音模式）
        try AVAudioSession.sharedInstance().setCategory(.playback, mode: .default)
        try AVAudioSession.sharedInstance().setActive(true)
    } catch {
        print("音频会话初始化失败: \(error.localizedDescription)")
    }
}

同时检查代码中是否有其他逻辑（如后台播放、语音功能）修改了音频会话状态，导致资源被抢占。

2. 验证自定义音效文件有效性 #

• 确认.aiff文件为PCM编码（16位、44.1kHz/48kHz，单声道/立体声均可），压缩格式的aiff会被系统拒绝播放
• 检查文件是否已添加到Target的Build Phases > Copy Bundle Resources中，避免打包时遗漏
• 打印文件URL验证路径正确性：

guard let soundURL = Bundle.main.url(forResource: "yourSound", withExtension: "aiff") else {
    print("音效文件未找到")
    return
}

3. 排查系统权限与限制 #

• 前往设置 > 你的App > 音频，确认音频播放权限已开启
• 检查「屏幕时间」是否设置了音频播放限制，部分自定义规则会禁用App音频功能

4. 跨设备/系统版本测试 #

• 在不同iOS版本（如16、17）的真机上测试，确认是否为特定系统版本的兼容性问题
• 用模拟器测试，区分是设备本地配置问题还是App代码逻辑问题

5. 排查第三方库冲突 #

• 检查近期引入的第三方库（如音频处理、直播、语音识别类），这类库可能会修改音频会话或抢占资源
• 查看Xcode控制台的AVFoundation/AudioToolbox相关日志，获取播放失败的具体错误信息

6. 重置设备音频状态 #

• 重启设备，修复系统音频服务的临时异常
• 执行设置 > 通用 > 传输或还原iPhone > 还原 > 还原所有设置（不会删除数据），重置系统音频配置

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