WSO2 API Manager Docker数据持久化配置失败求助

问题核心 #

卷映射后容器内运行时 artifacts 未同步到本地目录，重启后数据丢失，根源在于本地目录权限不匹配或卷映射语法错误——WSO2容器以wso2carbon用户（默认UID/GID为8080）运行，权限不对会导致容器无法写入数据。

修复步骤 #

1. 修复本地目录权限 #

先确保本地目标目录的权限允许WSO2容器用户读写：

sudo chown -R 8080:8080 /home/franklin/Desktop/composetest/dockerfiles/apim/server
sudo chmod -R 755 /home/franklin/Desktop/composetest/dockerfiles/apim/server

2. 调整docker-compose.yml卷映射 #

不要直接映射整个server目录，单独映射需要持久化的子目录，避免覆盖容器默认初始结构：

services:
  wso2apim:
    image: wso2/wso2am:4.0.0
    volumes:
      # 分别映射需要持久化的子目录
      - /home/franklin/Desktop/composetest/dockerfiles/apim/server/artifactMetafiles:/home/wso2carbon/wso2am-4.0.0/repository/deployment/server/artifactMetafiles
      - /home/franklin/Desktop/composetest/dockerfiles/apim/server/eventpublishers:/home/wso2carbon/wso2am-4.0.0/repository/deployment/server/eventpublishers
      - /home/franklin/Desktop/composetest/dockerfiles/apim/server/executionplans:/home/wso2carbon/wso2am-4.0.0/repository/deployment/server/executionplans
      # 如需持久化其他目录（如synapse-configs），继续添加映射
    ports:
      - "9443:9443"
      - "8280:8280"

3. 初始化容器默认数据（可选） #

如果需要保留容器内默认的初始 artifacts，先启动容器并拷贝对应目录内容到本地：

# 启动容器
docker compose up -d wso2apim
# 拷贝容器内的artifactMetafiles到本地
docker cp wso2apim:/home/wso2carbon/wso2am-4.0.0/repository/deployment/server/artifactMetafiles /home/franklin/Desktop/composetest/dockerfiles/apim/server/
# 同理拷贝其他目录
docker cp wso2apim:/home/wso2carbon/wso2am-4.0.0/repository/deployment/server/eventpublishers /home/franklin/Desktop/composetest/dockerfiles/apim/server/
docker cp wso2apim:/home/wso2carbon/wso2am-4.0.0/repository/deployment/server/executionplans /home/franklin/Desktop/composetest/dockerfiles/apim/server/
# 拷贝后重启容器
docker compose down && docker compose up -d

4. 验证配置 #

• 启动容器后，检查本地目录是否有文件生成
• 创建API后执行docker compose down && docker compose up -d，确认API未丢失
• 查看容器日志排查权限报错：

docker logs wso2apim

注意事项 #

• 禁止映射整个repository/deployment/server目录，会覆盖容器默认目录结构导致服务启动异常
• 确保本地目录UID/GID与容器内wso2carbon用户一致
• 你的Docker 23.0.1版本与WSO2 APIM 4.0.0镜像兼容，无需调整版本

内容的提问来源于stack exchange，提问作者César Yaranga Santé