使用SecretManagerServiceClient时，不借助try-with-resources如何避免ManagedChannelImpl错误？

问题背景 #

使用SecretManagerServiceClient时出现GRPC通道未正确关闭的错误：

i.g.i.ManagedChannelOrphanWrapper *~*~*~ Channel ManagedChannelImpl{logId=1, target=secretmanager.googleapis.com:443} was not shutdown properly!!! ~*~*~*
    Make sure to call shutdown()/shutdownNow() and wait until awaitTermination() returns true.
java.lang.RuntimeException: ManagedChannel allocation site

官方文档提示：

注意：需调用SecretManagerServiceClient对象的close()方法清理线程等资源，示例中使用的try-with-resources会自动调用close()。

但业务场景需要大量获取密钥，每次创建销毁客户端会带来性能与网络开销，希望通过依赖注入复用单个客户端。

最优解决方案：单例复用+生命周期管理 #

完全不需要每次创建销毁客户端，GRPC客户端本身是线程安全的，官方推荐复用单例实例，文档的try-with-resources只是针对单次使用的示例场景，并非强制要求。可以通过以下方式实现：

1. 依赖注入注册单例客户端 #

以Spring环境为例，将客户端注册为单例Bean，并指定销毁方法为close()，确保应用关闭时自动清理资源：

@Configuration
public class SecretManagerConfig {

    @Bean(destroyMethod = "close")
    public SecretManagerServiceClient secretManagerServiceClient() throws IOException {
        return SecretManagerServiceClient.create();
    }
}

其他DI框架（如Guice）可通过类似方式注册单例，并配置销毁钩子调用close()。

2. 手动管理生命周期（非DI场景） #

如果不使用依赖注入，可自行实现单例模式，并在应用关闭时调用close()：

public class SecretManagerClientHolder {
    private static SecretManagerServiceClient client;

    public static synchronized SecretManagerServiceClient getClient() throws IOException {
        if (client == null) {
            client = SecretManagerServiceClient.create();
        }
        return client;
    }

    // 应用关闭时调用此方法
    public static synchronized void shutdown() {
        if (client != null) {
            client.close();
            client = null;
        }
    }
}

在应用退出钩子中调用SecretManagerClientHolder.shutdown()，比如：

Runtime.getRuntime().addShutdownHook(new Thread(SecretManagerClientHolder::shutdown));

关键说明 #

• 复用单例客户端不会导致资源泄漏，只要在应用生命周期结束时调用close()，就能正确关闭GRPC通道，避免上述错误。
• GRPC客户端的连接是池化管理的，复用实例能大幅降低网络连接开销，提升大量获取密钥场景下的性能。

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