挂载失败与挂载点报错的逐项排查

按报错对号入座

「挂载点目录必须为空」

最常见的挂载报错。挂载点目录里已经有文件——通常是上一次挂载失败或提前退出留下的残留（那些文件在本地磁盘上，不在云上）：

1. 停掉正在往这个路径写东西的程序
2. 检查目录里的残留内容，确认没有需要保留的
3. 清空目录，重新挂载

防复发：让依赖这个路径的程序在挂载服务之后启动——把它的服务设为依赖挂载服务，或延迟启动。

「权限被拒绝」类

三种来源，按平台对号：

• Linux 非 root：/etc/fuse.conf 里 user_allow_other 没放开，见Linux 服务器部署 FUSE 挂载服务的完整流程
• macOS：macFUSE 内核扩展没放行（Apple 芯片要先进恢复模式授权），见Mac 上安装云盘挂载服务与内核扩展放行
• Docker：传播属性不是 shared，容器里挂载直接失败，见容器挂载看不见时的共享传播排查

盘符/目录出来了但别的程序看不见

• Windows 本地盘/网络盘类型：部分软件只认一种，换类型重建挂载点，见Windows 里给网盘分配盘符的设置步骤
• Docker 里的媒体库：给容器卷映射加 rslave，见容器媒体库看不见挂载盘的 rslave 解法
• 群晖 File Station：它无法在挂载盘里新建删除文件，是群晖侧已知问题，见各家 NAS 的套件安装指引

平台限制：这些挂载不了

完整对照表见只读挂载与开机自动挂载的防误删组合。

还不行的话

按「服务状态 → 驱动 → 平台」三层收窄：服务起没起（杀软拦截见杀毒软件拦截与防火墙端口放行）→ 驱动装没装（WinFSP 一键安装见Windows 里给网盘分配盘符的设置步骤）→ 平台允不允许（上表）。