Kotlin编写的Vert.x项目Docker部署：主Verticle文件无法找到

看起来你遇到的问题是Docker环境下运行Vert.x应用时，无法定位到指定的主Verticle，这主要是因为你配置的Verticle标识和Jar包内实际的类信息不匹配。让我帮你一步步梳理解决：

问题根源分析 #

从错误日志可以明确看到核心问题：

java.lang.IllegalStateException: Cannot find verticle script: OpenApiRoutingVerticle.kt on classpath

你在Dockerfile里指定的VERTICLE_NAME是Kotlin源代码文件名OpenApiRoutingVerticle.kt，但打包成Jar后，里面存储的是编译后的.class文件，此时应该使用完整的类全限定名来引用Verticle，而不是源代码文件名。你的主Verticle实际全路径是com.mycompany.department.OpenApiRoutingVerticle，这才是正确的标识。

修改后的Dockerfile #

FROM vertx/vertx3
# 使用编译后的类全限定名，去除.kt后缀
ENV VERTICLE_NAME com.mycompany.department.OpenApiRoutingVerticle
ENV VERTICLE_FILE build/libs/vertx-kotlin-project-1.0-SNAPSHOT.jar
ENV VERTICLE_HOME /usr/verticles

EXPOSE 8080

COPY $VERTICLE_FILE $VERTICLE_HOME/
WORKDIR $VERTICLE_HOME

# 优化启动命令，精准指定类路径
ENTRYPOINT ["sh", "-c"]
CMD ["exec vertx run $VERTICLE_NAME -cp $VERTICLE_HOME/$VERTICLE_FILE $VERTX_OPTIONS"]

关键修改说明 #

• VERTICLE_NAME调整：替换为类的全限定名com.mycompany.department.OpenApiRoutingVerticle，不再使用源代码文件名，因为Jar包中不存在.kt源文件。
• 类路径优化：将原来的-cp $VERTICLE_HOME/*改为-cp $VERTICLE_HOME/$VERTICLE_FILE，精准指向你的应用Jar，避免类路径中引入不必要的文件导致冲突。

额外验证建议 #

1. 先在本地验证Jar包的可运行性：

   vertx run com.mycompany.department.OpenApiRoutingVerticle -cp build/libs/vertx-kotlin-project-1.0-SNAPSHOT.jar
   

   如果本地能正常启动，说明类名和Jar包本身没有问题，再进行Docker镜像的构建和运行。

2. 构建并启动Docker镜像：

   docker build -t vertx-kotlin-app .
   docker run -p 8080:8080 vertx-kotlin-app
   

完成以上步骤后，应该就能解决Verticle找不到的问题了。

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