Android接入Google Calendar API遇KeyStoreException: JKS not found报错

异常触发本质 #

这个报错和你的授权流程、凭证文件配置没有直接关联，触发链路如下：

• 代码中调用GoogleNetHttpTransport.newTrustedTransport()构建HTTPS通信层时，老版本的工具类实现会硬编码要求加载JKS格式的JVM默认CA信任库，用于完成HTTPS请求的证书校验。
• 从JDK 9开始，OpenJDK/Oracle JDK的默认密钥库格式已经从JKS切换为PKCS12，当代码硬编码指定加载JKS格式的信任库时，就会因为当前JDK没有对应格式的密钥库加载实现，抛出java.security.KeyStoreException: JKS not found。

可落地修复方式 #

1. 手动构建适配当前JDK的HTTP通信层（推荐，无版本依赖问题） #

替换原代码中直接调用GoogleNetHttpTransport.newTrustedTransport()的逻辑，手动加载适配默认格式的信任库：

// 替换原代码里的信任传输初始化逻辑
SSLContext sslContext = SSLContext.getInstance("TLS");
// 使用JVM默认的信任管理器算法，自动适配当前JDK的密钥库格式
TrustManagerFactory trustManagerFactory = TrustManagerFactory.getInstance(TrustManagerFactory.getDefaultAlgorithm());
// 传入null参数，自动加载JVM内置的默认CA信任库，兼容PKCS12/JKS等不同格式
trustManagerFactory.init((KeyStore) null);
sslContext.init(null, trustManagerFactory.getTrustManagers(), new SecureRandom());

NetHttpTransport HTTP_TRANSPORT = new NetHttpTransport.Builder()
        .setSslSocketFactory(sslContext.getSocketFactory())
        .build();

替换后就不需要依赖Google工具类内置的硬编码JKS加载逻辑，从根源上避免格式不兼容问题。

2. 临时适配：强制全局密钥库格式为JKS #

如果不想改动现有代码逻辑，可以在程序启动的JVM参数中追加配置，强制把全局默认密钥库类型切回JKS：
-Dkeystore.type=JKS

注意：这个方案属于临时兼容手段，后续JDK版本会逐步移除对JKS格式的支持，不适合在生产环境长期使用。

3. 升级Google API客户端依赖 #

如果你当前使用的是1.28.0版本以下的旧版google-api-client系列依赖，可以直接升级到最新稳定版。新版本的GoogleNetHttpTransport.newTrustedTransport()已经完成了PKCS12格式信任库的适配，不会再硬编码要求加载JKS格式的密钥库。

代码中需要提前修正的潜在问题 #

修复完JKS报错后，以下问题会导致授权流程无法正常走完，建议提前排查：

• 凭证文件路径校验：当前代码中凭证文件路径写为/credential.json，需要确认文件实际存放在项目resources目录的根路径下，否则会抛出资源找不到的异常。
• 令牌目录权限校验：代码中设置的令牌持久化目录为本地tokens文件夹，需要确保运行程序的进程对该目录有读写权限，否则授权完成后无法保存刷新令牌，会重复触发授权流程。
• 回调端口校验：代码中设置的本地授权回调端口为8888，需要提前确认端口未被其他程序占用，否则会抛出端口绑定失败的错误。

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