OpenTelemetry电商演示项目Docker部署问题分析与解决方案

问题背景

在OpenTelemetry电商演示项目的Docker部署过程中，用户遇到了两个关键问题：产品列表无法正常显示以及欺诈检测服务启动失败。这些问题出现在Apple M1 Max硬件环境下，使用Docker 28.1.1版本进行部署时。

现象描述

部署完成后，前端界面显示"Go Shopping"链接，但产品列表为空。同时，后台的欺诈检测服务不断重启失败。从日志中可以看到，Java虚拟机在初始化时无法加载OpenTelemetry Java代理。

根本原因分析

通过日志分析，问题的核心在于Java应用程序无法找到或访问OpenTelemetry Java代理JAR文件。具体表现为：

1. 文件权限问题：Docker容器中的Java进程没有足够的权限访问/app/opentelemetry-javaagent.jar文件
2. 文件路径问题：代理JAR文件可能未被正确复制到容器内的指定位置
3. 架构兼容性问题：M1芯片的ARM架构可能导致某些镜像兼容性问题

解决方案

针对这个问题，可以采取以下解决方案：

1. 修改Dockerfile权限设置： 在fraud-detection服务的Dockerfile中，添加COPY指令的权限参数：

   COPY --chmod=777 opentelemetry-javaagent.jar /app/opentelemetry-javaagent.jar
   

2. 验证文件存在性： 在Dockerfile中添加验证步骤，确保文件被正确复制：

   RUN ls -la /app/opentelemetry-javaagent.jar
   

3. 使用兼容性镜像： 对于M1芯片，确保使用多架构兼容的Java基础镜像：

   FROM eclipse-temurin:21-jre-jammy
   

实施步骤

1. 定位到项目中的fraud-detection服务Dockerfile
2. 修改COPY指令，添加权限参数
3. 重新构建并启动服务：

   docker compose build --no-cache fraud-detection
   docker compose up -d
   

验证方法

1. 检查欺诈检测服务日志，确认不再出现代理加载错误
2. 访问前端界面，确认产品列表正常显示
3. 通过以下命令验证文件权限：

   docker exec -it <container_id> ls -la /app
   

技术原理

这个问题涉及到Docker容器内的文件权限管理和Java代理机制：

1. Java代理机制：Java应用程序通过-javaagent参数加载代理时，需要确保指定的JAR文件可读且格式正确
2. Docker文件权限：容器内的文件权限独立于宿主机，需要在构建时显式设置
3. 跨架构兼容性：ARM架构设备运行x86镜像时可能遇到兼容性问题

预防措施

为避免类似问题再次发生，建议：

1. 在Dockerfile中显式设置关键文件的权限
2. 添加文件存在性验证步骤
3. 针对不同硬件架构使用对应的基础镜像
4. 在CI/CD流程中加入部署验证步骤

通过以上解决方案，可以成功解决OpenTelemetry电商演示项目在Docker部署中的产品显示和欺诈检测服务启动问题。