iOS应用读取非接触式卡片时提示缺少必要权限(Missing required entitlements)

核心原因分析 #

你遇到的NFCError Code=2是因为权限配置不匹配或者权限文件未正确关联到项目，结合你的配置和iOS15.6版本，主要存在权限字段缺失、文件绑定错误等问题。

具体修复步骤 #

1. 补全权限文件的ISO7816相关配置 #

你的权限文件仅配置了TAG和NDEF格式，但Info.plist中已添加ISO7816的AID配置，说明你要读取的是ISO7816标准智能卡，必须在权限文件中同步添加对应权限字段：

更新后的权限文件代码：

<?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>com.apple.developer.nfc.readersession.formats</key>
    <array>
        <string>TAG</string>
        <string>NDEF</string>
    </array>
    <!-- 添加ISO7816权限字段，与Info.plist的AID保持一致 -->
    <key>com.apple.developer.nfc.readersession.iso7816.select-identifiers</key>
    <array>
        <string>A000000XXXXXX</string>
    </array>
</dict>
</plist>

2. 确保权限文件绑定到Xcode项目 #

权限配置无效常因未将权限文件关联到项目Build Settings：

• 选中项目target，切换到Build Settings标签
• 搜索Code Signing Entitlements
• 确认字段值为你的权限文件路径（如$(PRODUCT_NAME)/Entitlements.plist），为空则手动填入正确路径

3. 检查签名与构建配置 #

• 必须使用开发团队签名，个人免费签名不支持NFC权限
• 执行Cmd+Shift+K清理项目，再Cmd+B重新构建，重新安装到测试设备

4. 适配iOS15.6的会话初始化逻辑 #

iOS15及以后读取ISO7816卡片需注意：

• 初始化NFCTagReaderSession时，指定pollingOption包含.iso14443（ISO7816卡片多基于该标准）
• 读取ISO7816卡片必须使用NFCTagReaderSession，不可混用NFCNDEFReaderSession

额外验证点 #

• 确认测试卡片的AID与配置的A000000XXXXXX完全匹配，AID不匹配也可能触发权限类错误
• 重启测试设备，清除系统权限缓存

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