Android Studio安装有效服务器证书及构建失败问题排查与解决

当前使用的Android Studio版本 #

Android Studio Giraffe | 2022.3.1 Canary 10
Build #AI-223.8836.35.2231.9762515, built on March 17, 2023
Runtime version: 17.0.6+0-17.0.6b653.34-9746777 x86_64
VM: OpenJDK 64-Bit Server VM by JetBrains s.r.o.
macOS 12.6.1
GC: G1 Young Generation, G1 Old Generation
Memory: 2048M
Cores: 12
Metal Rendering is ON
Registry:
    external.system.auto.import.disabled=true
    ide.text.editor.with.preview.show.floating.toolbar=false
    ide.images.show.chessboard=true

Non-Bundled Plugins:
    com.android.aas (3.5.1)

问题现象 #

• 构建任意Android项目时，下载环节出现失败项
• 偏好设置的「Server Certificates」栏目下，多数证书显示过期

咨询问题及解答 #

1. 构建失败与过期证书是否相关？ #

是高度相关的。Android Studio构建时需从Maven仓库、Google Maven等服务器下载依赖、插件或SDK组件，这类HTTPS请求依赖证书验证身份。若服务器证书过期，Studio无法确认服务器合法性，会直接终止下载，引发构建失败。

2. 该情况是否需要担忧？ #

需要重视。一方面，过期证书会直接阻断依赖下载，导致项目无法正常构建；另一方面，若强行跳过证书验证，会增加中间人攻击风险，可能下载到被篡改的恶意文件。

3. 如何修复构建失败？ #

核心是解决证书验证问题，可按以下步骤操作：

• 升级Android Studio：当前使用的是2023年3月的预览版，存在较多未修复的网络及证书问题，优先升级到最新稳定版。
• 更新系统证书：在macOS打开「钥匙串访问」，删除过期的服务器证书，重新访问对应服务器（如dl.google.com、repo.maven.apache.org），系统会自动下载安装最新有效证书。
• 配置Studio复用系统证书：打开偏好设置 → 「Appearance & Behavior」→ 「System Settings」→ 「HTTP Proxy」，勾选「Use system proxy settings」，确保Studio使用系统已信任的证书。
• 清理缓存：点击「File」→ 「Invalidate Caches...」，选择「Invalidate and Restart」，清除旧缓存证书及失败下载记录。

Android Studio中安装有效服务器证书的步骤 #

1. 获取目标服务器的有效证书：
   打开浏览器访问目标服务器，点击地址栏锁形图标，查看证书详情并导出为.pem或.cer格式文件。
2. 导入证书到Studio：
   打开偏好设置 → 「Tools」→ 「Server Certificates」，点击右下角「+」按钮，选择导出的证书文件，勾选「Trust this certificate for SSL」后点击「OK」。
3. 验证生效：重启Android Studio，重新构建项目，检查下载失败项是否消失。

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