MinIO通过systemctl启动失败，但手动命令启动正常的排查求助

环境与操作背景 #

• 4台配置一致的Rocky Linux 8.7虚拟机，均挂载磁盘至/data/minio
• 已开放8080、8081端口，未配置TLS证书
• 按官方流程搭建MinIO多节点集群

操作步骤 #

1. 各节点安装MinIO二进制包：

   wget https://dl.min.io/server/minio/release/linux-amd64/archive/minio-20230407052858.0.0.x86_64.rpm -O minio.rpm
   sudo dnf install minio.rpm
   

2. 未修改RPM自动生成的systemd服务文件/etc/systemd/system/minio.service
3. 以root身份创建/etc/default/minio环境文件，内容如下：

   MINIO_VOLUMES="http://minio{1...4}.domain.com:8080/data/minio"
   MINIO_OPTS="--address :8080 --console-address :8081"
   MINIO_ROOT_USER=minioadmin
   MINIO_ROOT_PASSWORD=admin
   MINIO_SERVER_URL="http://minio1.domain.com:8080"
   

4. 启动异常：执行systemctl start minio.service失败，journalctl仅返回：

   minio.service: Main process exited, code=exited, status=1/FAILURE
   minio.service: Failed with result 'exit-code'.
   

   手动加载环境文件后执行/usr/local/bin/minio server $MINIO_OPTS $MINIO_VOLUMES可正常启动，能访问控制台并登录。

1. 检查运行用户权限 #

RPM安装的MinIO默认以minio-user用户运行，手动root执行成功大概率是权限不匹配：

• 检查/data/minio目录权限，确保minio-user拥有读写权限：

  ls -ld /data/minio
  sudo chown -R minio-user:minio-user /data/minio
  

• 确保/etc/default/minio文件可被minio-user读取：

  ls -l /etc/default/minio
  sudo chmod 644 /etc/default/minio
  

2. 验证systemd是否加载环境文件 #

默认的minio.service可能未指定加载/etc/default/minio，打开服务文件检查：

cat /etc/systemd/system/minio.service

确认[Service]段是否包含EnvironmentFile=/etc/default/minio，如果没有则添加，之后重新加载systemd配置：

sudo systemctl daemon-reload
sudo systemctl restart minio.service

3. 获取MinIO详细启动日志 #

systemd默认可能屏蔽了MinIO自身的报错，修改服务文件开启完整日志输出：

• 编辑/etc/systemd/system/minio.service，在[Service]段添加：

  StandardOutput=journal+console
  StandardError=journal+console
  

• 重新加载配置并查看实时日志：

  sudo systemctl daemon-reload
  sudo systemctl start minio.service
  journalctl -u minio.service -f --output=verbose
  

  此时能看到MinIO启动时的具体报错信息，精准定位问题。

4. 修复VOLUMES变量的通配符展开问题 #

systemd不会自动解析{1...4}这类shell通配符，而手动执行时是bash完成了展开。需要将MINIO_VOLUMES改为完整的节点列表：

MINIO_VOLUMES="http://minio1.domain.com:8080/data/minio http://minio2.domain.com:8080/data/minio http://minio3.domain.com:8080/data/minio http://minio4.domain.com:8080/data/minio"

修改后重启服务测试。

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