macOS Big Sur下Docker Desktop构建mediasoup demo崩溃报错咨询

你提供的报错原日志如下：

level=error msg="Handler for GET /system/df returned error: error getting build cache usage: failed to get usage for h23kzrlo9o1ntzqg8djaak2ql: snapshot 6p6vktbybxdisl2r4iovhkxaf not found"

报错核心含义 #

该故障和mediasoup-demo项目的代码逻辑无关，是macOS环境下Docker Desktop自身存储驱动的元数据错乱导致的：

• 报错触发的GET /system/df是Docker内置系统接口，功能是全量统计磁盘上所有镜像、容器、构建缓存、数据卷的实际占用量
• 具体故障链路：Docker在统计构建缓存用量时，尝试访问标识为h23kzrlo9o1ntzqg8djaak2ql的缓存条目，但其关联的底层磁盘快照6p6vktbybxdisl2r4iovhkxaf已经从Docker的内部存储索引中丢失
• 这种存储索引和实际快照不匹配的状态，在运行Big Sur系统的2018款Intel架构Mac上属于Docker Desktop的高频偶发问题，索引错乱后会连续抛出接口错误，最终触发Docker进程崩溃退出。

适配设备的排查操作 #

• 调整Docker资源配额：你的设备配备32GB内存，可在Docker Desktop的高级资源设置页为Docker分配8-12GB内存、4核CPU，避免构建mediasoup原生依赖模块时因内存不足出现存储写入中断，造成磁盘快照损坏
• 清理失效构建缓存：执行docker builder prune -af命令，删除所有和快照脱钩的无效缓存条目，避免后续每次调用磁盘统计接口时重复触发“快照不存在”的报错
• 校验系统权限配置：Big Sur的沙箱机制对应用文件访问管控较严格，需在Docker Desktop的文件共享设置中，为存放mediasoup-demo项目的目录开放完全读写权限，避免构建过程中因文件读写异常中断触发存储层错误
• 反复触发同类报错时的处理：通过Docker Desktop的故障排查入口选择重置磁盘镜像，创建全新的干净存储卷，即可彻底清除所有错位的元数据索引

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