自定义Debezium镜像在EKS启动失败：log4j.properties文件缺失

1. 检查Dockerfile的配置文件复制逻辑 #

• 确保Dockerfile里有将本地的log4j.properties复制到镜像的/opt/kafka/custom-config/目录，比如添加这条指令：

COPY log4j.properties /opt/kafka/custom-config/

• 构建镜像时，本地的log4j.properties要和Dockerfile在同一目录，或者填写正确的相对路径。
• 构建完成后，可本地运行镜像验证文件是否存在：docker run --rm 你的镜像名 ls /opt/kafka/custom-config/

2. 检查Kubernetes Deployment的挂载配置 #

如果是通过ConfigMap挂载配置文件：

• 先确认ConfigMap已正确创建，内容包含log4j.properties：

apiVersion: v1
kind: ConfigMap
metadata:
  name: debezium-log4j-config
data:
  log4j.properties: |
    # 填入你的log4j配置内容
    log4j.rootLogger=INFO, stdout
    # 其他配置项...

• 再检查Deployment里的volume和volumeMounts路径是否匹配：

spec:
  containers:
  - name: debezium-connector
    image: 你的ECR镜像地址
    volumeMounts:
    - name: log4j-config
      mountPath: /opt/kafka/custom-config/
      readOnly: true
  volumes:
  - name: log4j-config
    configMap:
      name: debezium-log4j-config

• 若只想替换单个文件、避免覆盖目录下其他必要文件，可使用subPath：

volumeMounts:
- name: log4j-config
  mountPath: /opt/kafka/custom-config/log4j.properties
  subPath: log4j.properties

3. 验证容器的环境变量设置 #

Debezium/Kafka通常通过环境变量指定log4j配置路径，确保LOG4J_CONFIG_FILE指向正确文件：

env:
- name: LOG4J_CONFIG_FILE
  value: /opt/kafka/custom-config/log4j.properties

如果未设置这个变量，默认可能读取其他路径，导致找不到自定义配置。

4. 排查镜像构建和推送问题 #

• 确认推送到ECR的镜像内容正确，可拉取到本地检查：

aws ecr get-login-password --region 你的区域 | docker login --username AWS --password-stdin 你的ECR仓库地址
docker pull 你的ECR镜像地址
docker run --rm 你的ECR镜像地址 cat /opt/kafka/custom-config/log4j.properties

• 如果拉取的镜像中不存在该文件，说明构建或推送环节出错，重新构建并推送镜像即可。

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