lijianfei.com

作为个人私有云相册的核心中枢，Immich 承载了我近百 GB 的珍贵历史照片与视频元数据。为了保障宿主机内置硬盘的空间充裕，我一直将 Immich 的全量媒体库与 PostgreSQL 数据库目录持久化在外置高速固态硬盘（/Volumes/X1/immich）上，并通过 macOS 平台下轻量高效的 OrbStack 虚拟机环境进行容器化驱动。

然而，在近期的日常维护与版本平滑演进中，这套外置存储架构却接连遭遇了两场惊心动魄的险情：先是在例行执行版本有保护升级（v3.2.2 至 v3.3.3）的全量冷备时，PostgreSQL 抛出了致命的数据页校验和损坏错误（page verification failed）；紧接着在宿主机休眠唤醒与重启后，immich-server 容器突发陷入了无休止的 Restarting (1) 崩溃循环，Web 前端彻底瘫痪。在这篇文章中，我将完整复盘这两起事故的底层技术根因，深入拆解 VirtioFS 跨层挂载下的文件同步陷阱、PostgreSQL 崩溃恢复机制与事务级坏块无损手术实操。

在日常将 Mac mini、Mac Studio 或 MacBook 作为常驻开发主机或家庭服务器使用时，许多开发者与极客都习惯外挂一块 4TB ~ 5TB 的大容量 2.5 英寸移动硬盘，用于备份 Time Machine、归档冷数据或存储影音素材。

然而，一个令人极度困扰的“幽灵故障”常常不期而至：明明硬盘数据线插得好好的，没有任何物理碰触，桌面和通知中心却经常无规律地弹出“磁盘未正常推出（Disk not ejected properly）”的红色强行断开警告。随后，硬盘往往会在几秒后重新被系统挂载识别，或者直接彻底掉盘消失。

很多人第一反应是“线材松了”、“硬盘出现坏道”，甚至是“macOS 系统的软件 Bug”。但当你真正潜入 macOS 内核日志、IOKit 硬件拓扑以及物理电气层面时，会发现事情远没有那么简单。

本文基于真实的生产排查现场与设备取证，深入剖析一块外接 4TB 机械移动硬盘在 Mac mini 环境下频繁异常退出的底层机理，并给出经过严格验证的系统调优参数与运维标准规范。