Quarkus Native模式注入Storage为何GCS默认凭证未被检测到？

核心原因 #

你的问题出在Quarkus Native模式的编译优化和Google Cloud SDK凭证加载的动态特性上：

1. 用CDI生产者提前创建Storage Bean时，Native编译过程可能没识别到GoogleCredentials.getApplicationDefault()依赖的所有动态加载类/资源，导致这些类被从镜像中剔除，运行时无法加载凭证。
2. 内联创建Storage的方式能正常工作，是因为Quarkus的自动检测机制（比如GCS相关扩展）会扫描到内联代码中的StorageOptions调用，自动添加必要的原生镜像配置，确保凭证加载逻辑被正确包含。

具体解决方案 #

方案1：改用Quarkus官方GCS扩展（推荐） #

直接使用quarkus-google-cloud-storage扩展，它已经帮你处理了Native模式下的所有适配问题，包括凭证加载和反射配置：

1. 添加依赖到pom.xml（或build.gradle）：

<dependency>
    <groupId>io.quarkus</groupId>
    <artifactId>quarkus-google-cloud-storage</artifactId>
</dependency>

2. 删除自定义的GcpStorageProducer类，直接注入Storage即可：

@Inject Storage storage;

3. 在application.properties中配置项目ID（按需）：

quarkus.google.cloud.project-id=${GCP_PROJECT_ID}

这个扩展会自动适配JVM和Native模式，在Cloud Run上自动获取默认凭证，同时也支持通过@IfBuildProfile配合测试用的LocalStorageHelper进行单元测试。

方案2：修复自定义生产者的Native适配 #

如果坚持自己写生产者，需要手动添加Native模式的反射配置：

1. 在GcpStorageProducer类上添加@RegisterForReflection注解，确保相关类被包含进镜像：

@Slf4j
@ApplicationScoped
@RegisterForReflection(targets = {
    GoogleCredentials.class,
    StorageOptions.class,
    // 可按需添加更多凭证相关类，比如ComputeEngineCredentials等
})
public class GcpStorageProducer {
    // 原有代码不变
}

2. 避免显式调用GoogleCredentials.getApplicationDefault()，让StorageOptions自动处理凭证加载，和你之前的内联代码逻辑一致：

@Produces
@DefaultBean
@ApplicationScoped
public Storage realStorage() {
    log.info("Producing GCS service bean with GCP project {}", runtime.gcpProject());
    return StorageOptions.newBuilder()
                         .setProjectId(runtime.gcpProject())
                         .build()
                         .getService();
}

3. 添加@Unremovable注解防止Bean被Native优化移除：

@Produces
@DefaultBean
@ApplicationScoped
@Unremovable
public Storage realStorage() {
    // ...
}

方案3：调整Bean初始化时机 #

如果是因为启动时Cloud Run元数据服务还没准备好，可以把Storage Bean的作用域改为@Dependent或@RequestScoped，让它在第一次使用时才初始化，而非应用启动阶段：

@Produces
@DefaultBean
@Dependent
public Storage realStorage() {
    // ...
}

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