Mac Big Sur部署DHIS2时core容器因server.xml chown权限不足重启如何解决

根因说明 #

该报错是macOS版Docker的osxfs文件系统挂载机制限制导致：你将宿主机的server.xml通过bind mount方式挂载到容器内路径时，宿主机挂载的文件默认禁止容器内进程修改文件所有者，哪怕容器内使用root用户执行chown操作也会被拦截，因此添加user: root参数不会生效。502错误是core容器启动失败，nginx网关找不到上游服务导致的，core容器正常启动后自动恢复。

永久修复方案（按优先级从高到低排序） #

方案1：给挂载的server.xml添加只读标记（推荐，改动最小） #

你不需要在容器内修改server.xml配置，直接给挂载路径加只读标识即可，Tomcat启动脚本检测到文件为只读时会跳过chown操作，不会触发报错。
修改docker-compose.yml中core服务的volumes配置，对应行修改为：

- ./config/server.xml:/usr/local/tomcat/conf/server.xml:ro

修改后重新执行docker-compose up -d即可生效。

方案2：自定义core镜像，把server.xml打包进镜像 #

如果需要动态修改镜像内Tomcat配置，不用bind mount宿主机文件，可在项目根目录新建Dockerfile-core：

# 基础镜像替换为你实际使用的DHIS2 core镜像地址
FROM ${DHIS2_CORE_IMAGE}
COPY ./config/server.xml /usr/local/tomcat/conf/server.xml
# 提前修改文件所有者，避免启动时chown
RUN chown tomcat:tomcat /usr/local/tomcat/conf/server.xml

然后修改docker-compose.yml的core配置，去掉server.xml的挂载行，添加build配置：

core:
  build:
    context: .
    dockerfile: Dockerfile-core
  # 保留其他原有配置，删除server.xml的volumes挂载行

执行docker-compose up -d --build重建容器即可。

方案3：修改宿主机文件权限与Docker共享配置 #

如果必须保留可写的bind mount配置，可执行两步操作：

1. 打开Docker Desktop设置，进入Resources -> File Sharing，将你的DHIS2项目所在目录添加到共享列表，保存后重启Docker
2. 在宿主机项目目录下执行命令修改server.xml权限：

chmod 666 ./config/server.xml

不推荐的操作说明 #

不需要通过提升容器集群权限、添加privileged: true特权参数、修改容器内用户权限的方式解决，该问题不是容器内权限不足导致，上述操作既无法解决问题还会引入安全风险。

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