部署至AWS Lambda时Quarkus Bootstrap启动失败如何排查解决？

核心报错原因 #

io.quarkus.runner.ApplicationImpl是Quarkus构建阶段自动生成的启动类，该类找不到说明你上传到AWS Lambda的部署包不符合Quarkus Lambda的运行要求，类加载器在Lambda运行环境的/var/task/目录下没有扫描到对应类文件。

排查解决步骤 #

• 确认依赖引入正确
  首先检查项目是否已经引入Quarkus官方AWS Lambda扩展：

<!-- Maven 依赖示例 -->
<dependency>
    <groupId>io.quarkus</groupId>
    <artifactId>quarkus-amazon-lambda</artifactId>
</dependency>

没有该扩展的话，构建阶段不会生成对应的启动类和适配逻辑。

• 确认打包命令正确
  不要使用普通的jar打包命令，要指定Quarkus的打包类型：
  Maven执行：
  ./mvnw clean package -Dquarkus.package.type=uber-jar
  Gradle执行：
  ./gradlew clean build -Dquarkus.package.type=uber-jar
  如果是构建原生镜像，对应参数调整为-Dnative即可。
• 确认部署包选择正确
  构建完成后不要上传普通的业务jar包，要上传Quarkus自动生成的function.zip文件，该压缩包已经按Lambda要求整理好了所有依赖、配置和启动类。如果手动打包，要确保所有class文件和依赖jar都在压缩包根目录，不能嵌套外层文件夹。
• 确认Lambda handler配置正确
  Quarkus Lambda应用不需要在控制台配置你自己写的LambdaSolver作为handler，应该填官方通用handler：
  io.quarkus.amazon.lambda.runtime.QuarkusStreamHandler::handleRequest
  你自己的处理类Quarkus会通过CDI自动扫描加载，手动指定自定义handler会跳过Quarkus的启动逻辑，直接触发类找不到异常。
• 确认自定义处理类注解正确
  你写的LambdaSolver类需要添加@ApplicationScoped注解，让Quarkus识别为CDI Bean，否则类里的@Inject注入的实例无法初始化，也可能间接导致启动失败。

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