如何解决 Xcode 签名证书和 Provisioning Profile 过期问题

在 iOS 应用开发过程中，签名证书和 Provisioning Profile 是确保应用安全性和合法性的关键组件。然而，当这些证书或配置文件过期时，开发者可能会遇到编译或归档失败的问题。本文将详细介绍如何解决 Xcode 中“iOS Distribution”证书未找到和 Provisioning Profile 过期的问题。

问题描述

当你尝试在 Xcode 中构建或归档 iOS 应用时，可能会遇到以下错误信息：

Error (Xcode): No signing certificate "iOS Distribution" found: No "iOS Distribution" signing certificate matching team ID "xxxx" with a private key was found.
Error (Xcode): Provisioning profile "20230621Dev_adHoc" expired on Apr 29, 2025.

这些错误表明：

Xcode 无法找到与团队 ID 匹配的“iOS Distribution”签名证书。
当前使用的 Provisioning Profile 已过期。

此外，Xcode 还会提示以下内容：

It appears that there was a problem signing your application prior to installation on the device.
Verify that the Bundle Identifier in your project is your signing id in Xcode.
Also try selecting 'Product > Build' to fix the problem.
Encountered error while archiving for device.

解决方案

1. 检查证书是否过期

首先，检查你的“iOS Distribution”证书是否过期。证书的有效期通常为一年，过期后需要重新生成。

检查证书有效期
1. 打开 钥匙串访问（Keychain Access）。
2. 在左侧栏中选择“登录”和“我的证书”。
3. 查找“iOS Distribution”证书，双击证书查看其详细信息，确认证书是否已过期。

如果证书已过期，需要重新生成证书。

2. 重新生成证书

重新生成“iOS Distribution”证书的步骤如下：

登录 Apple Developer 账户
- 打开浏览器，访问 Apple Developer。
- 使用你的 Apple ID 登录。
进入证书管理页面
- 在顶部菜单栏中选择“证书、ID 和配置文件”（Certificates, Identifiers & Profiles）。
创建新的证书
- 在左侧菜单中选择“证书”（Certificates）。
- 点击“+”按钮，添加一个新的证书。
- 选择“iOS Distribution”证书类型，然后点击“继续”（Continue）。
生成证书请求
- 按照提示在你的 Mac 上生成一个证书签名请求（CSR）文件。
- 打开“钥匙串访问”，选择“证书助理 > 从证书颁发机构请求证书”。
- 填写你的电子邮件地址和用户 ID，选择“存储在磁盘上”，然后点击“继续”。
- 保存 CSR 文件到本地。
上传 CSR 文件
- 返回 Apple Developer 网站，上传刚才生成的 CSR 文件。
- 点击“继续”并等待证书生成。
下载并安装证书
- 证书生成完成后，下载证书文件（.cer 格式）。
- 双击下载的证书文件，将其安装到钥匙串中。
验证证书
- 再次打开“钥匙串访问”，确认新的“iOS Distribution”证书已安装，并且包含私钥。

3. 更新 Provisioning Profile

如果 Provisioning Profile 已过期，也需要更新。

登录 Apple Developer 账户
- 访问 Apple Developer，使用你的 Apple ID 登录。
进入配置文件管理页面
- 在顶部菜单栏中选择“证书、ID 和配置文件”（Certificates, Identifiers & Profiles）。
- 在左侧菜单中选择“配置文件”（Provisioning Profiles）。
编辑过期的配置文件
- 找到过期的 Provisioning Profile（例如“20230621Dev_adHoc”）。
- 点击“编辑”（Edit）按钮。
重新生成配置文件
- 点击“生成”（Generate）按钮，重新生成新的配置文件。
- 下载新的配置文件到本地。
安装新的配置文件
- 双击下载的配置文件，Xcode 会自动将其添加到项目中。
清理旧的配置文件
- 打开终端，运行以下命令清理旧的配置文件：
```
rm -rf ~/Library/MobileDevice/Provisioning\ Profiles/
```
- 重新构建项目，Xcode 会自动下载新的配置文件。

4. 验证项目设置

在 Xcode 中，确保项目的签名设置正确：

打开项目
- 打开 Xcode，选择你的项目。
- 点击项目的名称，进入“Targets > Signing & Capabilities”选项卡。
手动管理签名
- 取消自动管理签名（关闭“Automatically manage signing”）。
- 手动选择新安装的“iOS Distribution”证书和新的 Provisioning Profile。
清理并构建项目
- 点击顶部菜单栏的“Product > Clean Build Folder”清理项目。
- 然后选择“Product > Build”重新构建项目。