执行sudo brew services start后mosquitto已加载但未运行求助

问题现象 #

执行启停命令后提示成功，但查看服务状态显示Mosquitto已加载却未运行，且不可调度：

hanpeng@hanpeng ~ % sudo brew services stop mosquitto
Stopping mosquitto... (might take a while)
==> Successfully stopped mosquitto (label: homebrew.mxcl.mosquitto)
hanpeng@hanpeng ~ % sudo brew services start mosquitto
==> Successfully started mosquitto (label: homebrew.mxcl.mosquitto)
hanpeng@hanpeng ~ % sudo brew services info mosquitto
mosquitto (homebrew.mxcl.mosquitto)
Running: ✘
Loaded: ✔
Schedulable: ✘

当前版本为2.0.14，无需升级。

排查与解决步骤 #

1. 直接启动进程查看错误日志 #

跳过brew services，手动启动Mosquitto并输出实时日志，这是定位问题最直接的方式：

/usr/local/sbin/mosquitto -c /usr/local/etc/mosquitto/mosquitto.conf

常见错误原因包括配置文件语法错误、端口被占用、日志目录权限不足等。

2. 检查默认端口占用 #

Mosquitto默认使用1883端口，检查是否被其他进程占用：

lsof -i :1883

如果有占用，可杀掉对应进程（替换PID为实际进程ID）：

sudo kill -9 PID

或者修改/usr/local/etc/mosquitto/mosquitto.conf中的port字段，更换为未被占用的端口。

3. 验证配置文件语法 #

检查配置文件是否存在语法错误：

mosquitto -c /usr/local/etc/mosquitto/mosquitto.conf -v

-v参数会输出详细的配置加载过程，能直接定位错误行和问题描述。

4. 修复文件/目录权限 #

确保Mosquitto的配置目录、日志目录权限正确，避免因权限不足无法启动：

# 检查配置目录权限
ls -l /usr/local/etc/mosquitto/
# 检查日志目录权限（若不存在则创建）
sudo mkdir -p /usr/local/var/log/mosquitto/
sudo chown mosquitto:mosquitto /usr/local/var/log/mosquitto/

5. 重置brew服务配置 #

如果是launchd服务配置损坏，卸载并重新加载服务：

sudo brew services uninstall mosquitto
sudo rm -f ~/Library/LaunchAgents/homebrew.mxcl.mosquitto.plist
sudo brew services install mosquitto

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