如何排查Ktor打包成Fat JAR启动时的‘Neither port nor sslPort specified’错误

错误信息 #

Exception in thread "main" java.lang.IllegalArgumentException: Neither port nor sslPort specified. Use command line options -port/-sslPort or configure connectors in application.conf

可能的原因 #

• 应用的application.conf配置文件中，未配置HTTP或HTTPS连接器的端口参数
• 打包Fat JAR时，application.conf未被正确包含到JAR的类路径中，导致启动时无法读取配置
• 启动命令未通过-port或-sslPort参数指定端口
• application.conf中的端口配置存在语法错误（如键名拼写错误、值格式非法），导致应用无法识别配置项

排查与解决步骤 #

1. 检查配置文件内容
   打开项目中的application.conf，确认是否包含符合框架要求的端口配置，以Play框架为例：

   # HTTP端口配置
   play.http.port = 8080
   # HTTPS端口配置（如果需要）
   play.http.ssl.port = 8443
   

   注意不同框架的配置键名可能不同，需对应框架规范调整。

2. 验证配置文件是否在Fat JAR中
   使用解压命令查看Fat JAR内容：

   unzip your-app-fat.jar -d temp-unpack
   

   检查temp-unpack/BOOT-INF/classes（Spring Boot类路径）或对应框架的类路径目录下是否存在application.conf。

3. 命令行指定端口测试
   直接通过启动参数指定端口，验证是否能正常启动：

   java -jar your-app-fat.jar -port 8080
   

   若能启动，说明问题出在配置文件的读取或内容上。

4. 检查配置文件语法
   排查application.conf中的语法问题，比如缺少等号、引号不闭合、注释格式错误等。部分框架提供配置验证工具，可用于检测文件合法性。

5. 确认打包配置
   检查打包工具（如sbt-assembly、maven-shade-plugin）的配置，确保application.conf未被排除或覆盖，且被正确打包到类路径下。

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