Zipkin Docker配置Java堆空间报错找不到Xms1g主类如何解决

该报错由JVM启动参数格式错误触发：传入的JAVA_OPTS环境变量中，第一个堆内存参数Xms1g缺失JVM参数要求的前置短横线-。Java启动时会将所有不带-前缀的传入值识别为待运行的主类名，因此尝试加载名为Xms1g的类，最终抛出找不到主类、类不存在的错误。
使用M1芯片的Mac设备时，Docker运行x86架构镜像默认可能存在架构兼容问题，启动时建议额外指定平台参数规避异常。

• 先清理之前创建的异常容器

docker rm -f zipkin

• 修正参数格式重新启动容器，补上Xms1g前缺失的-，同时追加M1设备需要的平台适配参数：

docker run \
-e JAVA_OPTS="-Xms1g -Xmx1g -XX:+ExitOnOutOfMemoryError" \
--platform linux/amd64 \
--name zipkin -p 2005:9411 -d openzipkin/zipkin:latest

• 启动后执行日志查看命令验证状态，无报错即启动成功：

docker logs zipkin

Zipkin官方镜像内置了堆内存专用配置项JAVA_HEAP，不需要手动拼接JAVA_OPTS参数即可直接设置堆大小，能避免参数格式写错的问题，等效配置命令如下：

docker run \
-e JAVA_HEAP=1g \
--platform linux/amd64 \
--name zipkin -p 2005:9411 -d openzipkin/zipkin:latest

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