brew services 启动服务失败：Input/output error 解决方案

问题概述：在使用 Homebrew 启动服务（如 MongoDB、PostgreSQL 等）时遇到 "Bootstrap failed: 5: Input/output error" 错误，通常与权限、配置文件残留或系统服务管理相关。

问题原因分析

此错误通常由以下几种情况引起：

1. 权限问题：Homebrew 相关目录的所有权不正确
2. 残留文件：之前安装残留的 .pid、.sock 或配置文件
3. 端口冲突：服务已以其他用户身份运行并占用了相同端口
4. 版本不兼容：数据库文件与当前服务版本不兼容
5. 系统权限：macOS 网络或系统权限需要更新

解决方案

1. 基础排查步骤

首先尝试最简单的解决方案：

# 停止并重新启动服务
brew services stop mongodb-community
brew services restart mongodb-community

如果问题仍然存在，继续以下步骤。

2. 清理和重置服务

基本清理

# 清理brew服务
brew services cleanup

# 卸载并重新安装
brew uninstall mongodb-community
brew install mongodb-community

# 完全停止和卸载启动代理
brew services stop mongodb-community
launchctl bootout gui/$(id -u) ~/Library/LaunchAgents/homebrew.mxcl.mongodb-community.plist

# 删除旧的plist文件
rm -f ~/Library/LaunchAgents/homebrew.mxcl.mongodb-community.plist

手动加载/卸载

# 手动卸载启动代理
launchctl unload -w ~/Library/LaunchAgents/homebrew.mxcl.mongodb-community.plist

# 手动加载启动代理
launchctl load -w ~/Library/LaunchAgents/homebrew.mxcl.mongodb-community.plist

# 或者使用remove命令
launchctl remove homebrew.mxcl.mongodb-community

3. 权限修复

WARNING

确保将路径替换为您实际使用的路径

# 修复Homebrew目录所有权
sudo chown -R $(whoami) $(brew --prefix)/*

# 创建必要的目录并设置权限
mkdir -p /opt/homebrew/var/mongodb
mkdir -p /opt/homebrew/var/log
sudo chown -R $(whoami) /opt/homebrew/var/mongodb /opt/homebrew/var/log

4. 检查日志文件

TIP

查看日志是诊断问题的关键步骤，可以找到具体的错误信息

# MongoDB日志
tail -n 50 /opt/homebrew/var/log/mongodb/mongo.log

# PostgreSQL日志
tail -n 100 /usr/local/var/log/postgresql@11.log

常见的日志错误和解决方案：

• 权限错误：使用 chown 修复目录所有权
• 端口占用：停止冲突进程或更改服务配置
• 版本不兼容：需要迁移数据或设置兼容性版本
• 残留pid文件：删除残留的 .pid 文件

5. 系统级解决方案

# 安装Xcode命令行工具（解决系统依赖问题）
xcode-select --install

# 升级所有Homebrew包
brew upgrade

# 最后手段：重启系统
sudo reboot

特定场景解决方案

数据库版本升级问题

当升级数据库版本（如PostgreSQL 13→14）时：

# 设置兼容性版本（在旧版本中运行）
db.adminCommand({ setFeatureCompatibilityVersion: "5.0" })

# 然后升级到新版本

端口冲突解决

# 检查端口占用情况
lsof -i :27017  # MongoDB默认端口
lsof -i :5432   # PostgreSQL默认端口

# 停止占用端口的进程
kill -9 <PID>

残留文件清理

# 删除残留的sock文件
sudo rm -f /tmp/mongodb-27017.sock

# 删除残留的pid文件（根据日志提示路径）
rm /usr/local/var/postgresql@11/postmaster.pid

预防措施

1. 定期清理：定期运行 brew services cleanup
2. 正确停止服务：使用 brew services stop 而不是强制终止进程
3. 备份配置：修改重要配置前进行备份
4. 注意升级兼容性：升级前检查数据库版本兼容性

总结

"Input/output error" 错误通常不是真正的I/O错误，而是Homebrew服务管理层面的问题。通过系统性的排查（权限检查、日志分析、残留清理），大多数情况下可以快速解决。如问题持续存在，考虑重启系统或重新安装相关软件。

INFO

如果所有解决方案都无效，可以尝试直接运行服务二进制文件（如 mongod --dbpath /opt/homebrew/var/mongodb）来获取更详细的错误信息。