运行Jenkins报错：无法读取/var/jenkins_home/config.xml（Docker Compose环境）

错误原因 #

出现java.io.IOException: Unable to read /var/jenkins_home/config.xml通常是Docker卷权限不正确或config.xml文件损坏/缺失导致的，以下是具体解决步骤：

步骤1：修复Docker卷权限 #

1. 停止当前Jenkins容器

   docker-compose down
   

2. 查找jenkins_home卷的实际挂载路径

   docker volume inspect jenkins_home
   

   输出中Mountpoint字段即为实际路径，例如/var/lib/docker/volumes/jenkins_home/_data
3. 修改路径权限，赋予Jenkins用户（默认UID为1000）所有权

   sudo chown -R 1000:1000 /var/lib/docker/volumes/jenkins_home/_data
   

4. 重新启动Jenkins容器

   docker-compose up -d
   

步骤2：修复或替换损坏的config.xml #

如果权限修复后仍报错，大概率是config.xml文件损坏：

1. 备份现有config.xml文件

   sudo cp /var/lib/docker/volumes/jenkins_home/_data/config.xml /var/lib/docker/volumes/jenkins_home/_data/config.xml.bak
   

2. 删除损坏的文件

   sudo rm /var/lib/docker/volumes/jenkins_home/_data/config.xml
   

3. 重启Jenkins，容器会自动生成默认的config.xml

   docker-compose up -d
   

   注意：此操作会重置Jenkins基础配置，需要重新完成初始化设置。

步骤3：验证Docker Compose配置 #

确保你的Docker Compose文件结构正确（YAML大小写敏感），完整配置示例如下：

version: '3'
services:
  jenkins:
    image: jenkins/jenkins:lts
    ports:
      - "8080:8080"
      - "50000:50000"
    volumes:
      - jenkins_home:/var/jenkins_home
volumes:
  jenkins_home:

确认volumes字段位于顶级层级（与services同级），避免缩进错误。

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