.NET MAUI iOS端集成MSAL遇安装完整性验证失败问题求助

核心问题分析 #

你遇到的矛盾点本质是：添加com.microsoft.adalcache钥匙串组到entitlements.plist后，模拟器正常但真机部署触发完整性验证错误；移除该文件后真机可部署但MSAL因无钥匙串权限报错。根源是entitlements配置与Apple开发者门户的App ID、签名配置文件不匹配，且你可能未正确启用App ID的Keychain Sharing能力。

解决步骤 #

1. 启用App ID的Keychain Sharing能力 #

• 登录Apple开发者门户，进入Certificates, Identifiers & Profiles → Identifiers
• 找到应用对应的Explicit App ID（注意：Wildcard通配符App ID不支持Keychain Sharing，必须使用明确的Bundle ID）
• 进入App ID详情页，在Capabilities列表中找到Keychain Sharing并勾选启用
• 在配置框中添加钥匙串组：[你的Team ID].com.microsoft.adalcache（Team ID可在开发者门户Membership页面查看）
• 保存App ID配置

2. 重新生成签名配置文件 #

• 回到Certificates, Identifiers & Profiles → Profiles
• 找到当前使用的开发者/Adhoc配置文件，点击Edit
• 确认配置文件关联的App ID已启用Keychain Sharing，点击Generate重新生成配置文件
• 下载新配置文件，替换本地项目中的旧文件（或在Visual Studio/Xcode中刷新配置）

3. 修正entitlements.plist配置 #

使用动态变量避免硬编码Team ID，确保配置与开发者门户一致，示例如下：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>keychain-access-groups</key>
    <array>
        <string>$(AppIdentifierPrefix)com.microsoft.adalcache</string>
    </array>
</dict>
</plist>

$(AppIdentifierPrefix)会自动替换为你的Team ID前缀，避免手动填写出错。

4. 验证MAUI项目iOS配置 #

• 在Visual Studio中右键MAUI项目 → 属性 → iOS
• 确认Bundle Identifier与开发者门户的App ID完全一致
• 在Signing选项中选择刚重新生成的配置文件
• 确认Custom Entitlements路径正确指向你的entitlements.plist

5. 清理重建项目 #

• 执行Clean Solution清理项目缓存
• 删除iOS设备上已安装的旧应用
• 重新生成项目并部署到真机

额外排查点 #

• 若找不到Keychain Sharing选项：检查App ID是否为Explicit类型，Wildcard App ID不支持该能力
• 确认账号权限：个人/企业账号均支持Keychain Sharing，团队账号需确保你有配置App ID的权限
• 检查配置文件有效性：在Xcode中打开配置文件，查看Entitlements部分是否包含keychain-access-groups条目

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