.NET MAUI Mac Catalyst打包报错：Bundle Identifier与配置文件不匹配

核心问题定位 #

错误信息里的'fr.myCompany.appName (explicit)'显示，项目的Bundle Identifier被自动追加了(explicit)后缀，导致和Apple开发者后台创建的配置文件里的纯Bundle ID（比如fr.myCompany.appName）无法匹配。

具体解决步骤 #

1. 修正项目的Bundle Identifier配置 #

打开项目的.csproj文件，定位到Mac Catalyst对应的PropertyGroup节点，确保ApplicationId是纯净的Bundle ID，无多余后缀：

<PropertyGroup Condition="'$(TargetFramework)' == 'net7.0-maccatalyst'">
  <ApplicationId>fr.myCompany.appName</ApplicationId>
  <ApplicationIdDisplayName>你的应用名称</ApplicationIdDisplayName>
</PropertyGroup>

同时检查Platforms/MacCatalyst目录下的Info.plist文件，确认CFBundleIdentifier的值和上述ApplicationId完全一致。

2. 清理本地配置文件缓存 #

Apple配置文件的本地缓存可能引发识别异常，执行以下操作：

• 打开钥匙串访问，删除所有和当前Bundle ID相关的证书、配置文件
• 前往~/Library/MobileDevice/Provisioning Profiles目录，删除所有配置文件
• 重新从Apple开发者后台下载并安装对应配置文件

3. 排查SDK版本问题 #

你使用的Mac Catalyst SDK版本16.4.7090可能存在自动给Bundle ID加后缀的已知bug，可尝试：

• 执行dotnet update将.NET 7 SDK更新至最新补丁版本
• 切换到更稳定的Mac Catalyst SDK版本（比如16.2.x系列）

4. 清理构建缓存并重置项目 #

执行命令清理项目缓存，避免旧配置干扰：

dotnet clean -f net7.0-maccatalyst -c Release
rm -rf obj bin
dotnet restore

5. 配置手动签名参数 #

在.csproj的Mac Catalyst配置节点中明确指定手动签名和配置文件名称，确保和安装的配置文件名称完全匹配：

<PropertyGroup Condition="'$(TargetFramework)' == 'net7.0-maccatalyst'">
  <CodesignProvision>bundleIDName</CodesignProvision>
  <ManualSigning>true</ManualSigning>
</PropertyGroup>

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