.NET MAUI迁移后发布IPA至TestFlight失败及Json反序列化异常问题

关于ILLink错误（IL1040） #

这个错误是因为.NET MAUI的默认Linker行为在Release模式下会裁剪掉它认为未被使用的程序集/类型，而System.Security.Permissions.FileIOPermissionAccess属于已过时的.NET Framework兼容API，MAUI默认不包含这些引用。你添加的copyused相关属性（大概率是<CopyUsedAssembliesOnly>false</CopyUsedAssembliesOnly>）本质是关闭了部分Linker裁剪逻辑，虽然解决了IL1040，但也引发了Newtonsoft.Json的问题。

关于Newtonsoft.Json反序列化失败 #

这既不是NuGet包的问题，也不是发布命令缺少参数，而是Linker过度裁剪了Newtonsoft.Json运行时依赖的必要类型。当你全局关闭CopyUsedAssembliesOnly时，Linker无法正确识别Newtonsoft.Json通过反射调用的类型，导致这些类型被移除，最终反序列化失败。

正确的解决步骤 #

1. 精准修复ILLink错误，保留合理裁剪 #

不需要全局关闭CopyUsedAssembliesOnly，而是通过Linker配置文件保留所需类型：

• 在项目中新建Linker.xml文件，设置其生成操作为LinkDescription
• 写入以下内容：

<linker>
  <assembly fullname="System.Security.Permissions">
    <type fullname="System.Security.Permissions.FileIOPermissionAccess" preserve="all" />
  </assembly>
</linker>

这样既保留了触发错误的类型，又不会破坏Linker的优化逻辑。

2. 避免Newtonsoft.Json被过度裁剪 #

通过Linker配置保留Newtonsoft.Json的必要类型，有两种方式：

• 如果你使用的是Newtonsoft.Json 13.0.1及以上版本，它自带Linker配置，通常无需额外操作；若仍有问题，手动添加：

<linker>
  <assembly fullname="Newtonsoft.Json">
    <type fullname="Newtonsoft.Json.*" preserve="all" />
  </assembly>
</linker>

• 更精准的方式是保留你反序列化用到的实体类（推荐，减少包体积）：

<linker>
  <assembly fullname="你的应用程序集名称">
    <type fullname="你的命名空间.目标实体类" preserve="all" />
  </assembly>
</linker>

3. 优化发布命令（可选） #

你的发布命令本身没有问题，可添加-p:LinkerBehavior=SdkOnly明确Linker只裁剪非SDK程序集，降低冲突概率：

dotnet publish -f net7.0-ios -c Release -p:ArchiveOnBuild=true -p:RuntimeIdentifier=ios-arm64 -p:CodesignKey="MY-KEY" -p:CodesignProvision="MY-PROFILE" -p:LinkerBehavior=SdkOnly

总结 #

• ILLink错误是Linker裁剪过时安全权限类型导致的，通过Linker.xml精准保留即可解决，无需全局关闭裁剪
• Newtonsoft.Json问题是裁剪引发的运行时类型缺失，配置Linker保留必要类型即可修复
• 发布命令本身无参数缺失，调整Linker配置是核心解决方案

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