Nix-installer在MacOS系统升级后的故障排查与修复指南

问题背景

当MacOS系统从14.5升级到14.6.1版本后，许多用户报告Nix软件包管理系统出现了严重故障。这些故障表现为：

1. Nix安装的软件包突然不可用
2. 系统弹出要求解密Nix Store的密码对话框
3. Nix命令完全失效
4. 尝试重新安装时出现各种错误

故障现象分析

升级后的主要症状包括：

• 系统提示需要解密Nix Store卷的密码
• 重新安装时出现receipt.json解析错误
• 卸载过程中遇到APFS卷无法卸载的问题
• 各种系统服务(如launchctl)启动失败
• Home Manager配置文件锁文件丢失

根本原因

MacOS系统升级过程中会：

1. 清除Nix写入的各种shell钩子脚本
2. 可能破坏Nix Store卷的加密状态
3. 干扰Nix守护进程的正常运行
4. 重置部分系统配置和权限

解决方案

1. 初始修复尝试

首先尝试使用Nix自带的修复工具：

/nix/nix-installer repair

这个命令会尝试修复shell脚本相关的配置问题。

2. 完全卸载Nix

如果修复无效，需要完全卸载后重新安装：

/nix/nix-installer uninstall

卸载过程中可能会遇到APFS卷无法卸载的问题，这是因为系统进程仍在使用该卷。此时需要：

1. 重启系统
2. 手动删除Nix Store卷：

sudo /usr/sbin/diskutil apfs deleteVolume "Nix Store"

3. 清理残留配置

卸载后检查并清理以下内容：

• /etc/nix/nix.conf 配置文件
• /Library/LaunchDaemons/ 下的Nix相关服务文件
• 用户主目录下的Nix相关配置

4. 重新安装Nix

使用官方安装脚本重新安装：

curl --proto '=https' --tlsv1.2 -sSf -L https://install.determinate.systems/nix | sh -s -- install

5. 修复Home Manager问题

如果遇到Home Manager配置文件锁问题，可以：

1. 手动创建缺失的目录结构：

mkdir -p /nix/var/nix/profiles/per-user/$USER

2. 重置Home Manager配置

预防措施

1. 在MacOS系统升级前，建议：

   • 备份重要Nix配置
   • 记录Nix Store加密密码
   • 考虑临时卸载Nix

2. 升级后立即运行：

/nix/nix-installer repair

3. 定期检查Nix系统服务的运行状态

技术细节

Nix Store卷加密机制

Nix在MacOS上使用APFS加密卷存储所有软件包。系统升级可能会：

• 重置钥匙串中的加密密码
• 改变卷的挂载状态
• 干扰加密卷的自动挂载机制

launchd服务管理

Nix依赖launchd管理的系统服务包括：

• org.nixos.nix-daemon.plist
• org.nixos.darwin-store.plist
• systems.determinate.nix-installer.nix-hook.plist

系统升级可能导致这些服务配置失效或无法正常启动。

总结

MacOS系统升级对Nix的影响主要来自系统级配置重置和加密卷处理机制的改变。通过系统性的卸载、清理和重新安装，大多数问题都可以解决。未来版本的nix-installer将改进修复机制，减少此类问题的发生频率和影响范围。