容器中ActiveMQ Artemis配置覆盖失败：文件锁与路径错误排查

问题背景 #

用Docker Compose运行ActiveMQ Artemis 2.37，想自定义实例/var/lib/artemis-instance/etc下的配置文件，本地把配置存在config/activemq/etc路径，但试了好几种挂载方式都启动失败，碰到两类错误：

错误1：文件不存在异常 #

[org.apache.activemq.artemis.core.server] AMQ224097: Failed to start server
java.io.IOException: No such file or directory
    at java.base/java.io.UnixFileSystem.createFileExclusively0(Native Method) ~[?:?]
    at java.base/java.io.UnixFileSystem.createFileExclusively(Unknown Source) ~[?:?]
    at java.base/java.io.File.createNewFile(Unknown Source) ~[?:?]
    at org.apache.activemq.artemis.core.server.impl.FileBasedNodeManager.setUpServerLockFile(FileBasedNodeManager.java:145

错误2：锁验证异常 #

Lock appears to be valid; triple check by comparing timestamp
Validating lastModified 1743369098346 modified = 1743369098346 on file:/var/lib/artemis-instance/etc/
Validating lastModified 1743369098395 modified = 1743369098395 on file:/var/lib/artemis-instance/./etc//broker.xml

试过的挂载方式：

• 最初只挂artemis_data:/var/lib/artemis-instance，无法覆盖配置
• 加挂./config/activemq/etc:/var/lib/artemis-instance/etc-override，启动失败
• 把原卷改成只挂artemis_data:/var/lib/artemis-instance/data，还是不行
• 换成本地目录挂./config/activemq/state:/var/lib/artemis-instance，依旧失败

当前Compose配置片段：

activemq:
  image: apache/activemq-artemis:${artemis.version}
  container_name: activemq
  restart: always
  environment:
    ARTEMIS_MIN_MEMORY: 512M
    ARTEMIS_MAX_MEMORY: 1024M
    ARTEMIS_USER: ${BROKER_USERNAME}
    ARTEMIS_PASSWORD: ${BROKER_PASSWORD}
  volumes:
    - artemis_data:/var/lib/artemis-instance/data
    - "./config/activemq/etc-override:/var/lib/artemis-instance/etc-override"
  networks:
    - my-network

正确解决方案 #

ActiveMQ Artemis官方镜像自带配置覆盖机制，不用直接替换默认的etc目录，避免破坏容器内的目录结构和锁文件逻辑。

1. 准备本地配置 #

把要修改的broker.xml、jolokia-access.xml等配置文件放到本地./config/activemq/etc目录，调整权限适配容器内的artemis用户（UID=1000）：

chown -R 1000:1000 ./config/activemq/etc

2. 修改Compose配置 #

添加ARTEMIS_INSTANCE_ETC_OVERRIDE环境变量，指定容器内的覆盖目录，同时挂载本地配置到该路径：

activemq:
  image: apache/activemq-artemis:${artemis.version}
  container_name: activemq
  restart: always
  environment:
    ARTEMIS_MIN_MEMORY: 512M
    ARTEMIS_MAX_MEMORY: 1024M
    ARTEMIS_USER: ${BROKER_USERNAME}
    ARTEMIS_PASSWORD: ${BROKER_PASSWORD}
    # 指定配置覆盖目录，镜像会自动用这里的文件覆盖默认etc目录的同名文件
    ARTEMIS_INSTANCE_ETC_OVERRIDE: /var/lib/artemis-instance/etc-override
  volumes:
    # 保留数据目录持久化，不影响默认配置结构
    - artemis_data:/var/lib/artemis-instance/data
    # 本地配置目录挂载到容器内的覆盖路径
    - "./config/activemq/etc:/var/lib/artemis-instance/etc-override"
  networks:
    - my-network

3. 关键逻辑说明 #

镜像启动时会自动扫描ARTEMIS_INSTANCE_ETC_OVERRIDE目录下的文件，用这些文件替换默认/var/lib/artemis-instance/etc里的同名文件，既保留了容器内原有的目录结构（避免锁文件缺失或冲突），又能加载自定义配置。

排查要点 #

• 要是还出锁文件错误，检查是不是多个容器实例在抢同一个数据目录，本地挂载的话确认目录没被其他进程占用
• 确保本地配置文件语法正确，符合Artemis 2.37的要求（比如broker.xml的XML格式不能错）
• 绝对不要直接挂载本地目录到/var/lib/artemis-instance，这会覆盖容器内默认的目录和必要文件，引发各种启动异常

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