Xamarin.Forms iOS真机测试遇MTOUCH程序集链接错误求解决

从你遇到的问题和提供的MSBuild日志来看，这个链接器错误的核心诱因是大量程序集版本冲突——日志里一堆系统程序集（比如System.Runtime、System.Diagnostics.Debug）和第三方库（Newtonsoft.Json）都存在多版本冲突，MSBuild只能"随意选择"一个版本，这种不确定性很容易导致链接器在处理时出现空引用异常。

下面是几个针对性的解决方案，按优先级尝试：

1. 统一所有项目的NuGet包版本 #

这是最关键的一步，版本不一致是冲突的根源：

• 右键点击解决方案，选择「管理解决方案的NuGet程序包」
• 切换到「Consolidate」标签页，这里会列出所有跨项目版本不一致的包
• 把所有冲突的包（尤其是Xamarin.Forms、Newtonsoft.Json、System系列的NuGet包）统一升级到同一个稳定版本，优先选较新的兼容版本

2. 调整iOS链接器设置（别直接关闭） #

直接关闭链接器会导致安装包体积暴增，还可能引发其他运行时问题，试试更精细的设置：

• 打开iOS项目属性 → iOS Build → 链接器行为
• 选择「仅链接SDK程序集」（Link SDK assemblies only）：这个选项只优化系统SDK的程序集，保留你的应用代码和第三方库，能大幅降低冲突概率
• 如果还是报错，试试添加链接器描述文件（Linker.xml）到iOS项目中，手动指定需要保留的程序集，避免链接器误删必要代码：

  <linker>
    <!-- 替换成你的应用程序集名称 -->
    <assembly fullname="YourApp.MainAssembly" />
    <!-- 保留Newtonsoft.Json避免被误删 -->
    <assembly fullname="Newtonsoft.Json" />
  </linker>
  

3. 彻底清理缓存后重建 #

旧编译缓存经常会放大版本冲突问题：

• 执行「Build → Clean Solution」清理整个解决方案
• 手动删除所有项目下的bin和obj文件夹（可以用资源管理器批量删除）
• 重启Visual Studio，然后重新生成解决方案并部署到真机

4. 移除手动添加的旧程序集引用 #

检查iOS项目的引用列表，如果有手动添加的旧版本System系列程序集（比如直接从本地文件夹添加的），立即移除这些引用——改用NuGet包来管理这些依赖，Xamarin会自动处理正确的版本绑定。

5. 添加程序集绑定重定向（强制统一版本） #

如果上面的步骤还没解决，可以在iOS项目的.csproj文件中添加绑定重定向，强制MSBuild使用指定版本：

<PropertyGroup>
  <!-- 原有属性保持不变 -->
</PropertyGroup>
<!-- 添加下面的绑定重定向 -->
<runtime>
  <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
    <dependentAssembly>
      <assemblyIdentity name="Newtonsoft.Json" publicKeyToken="30ad4fe6b2a6aeed" culture="neutral" />
      <bindingRedirect oldVersion="0.0.0.0-9.0.0.0" newVersion="9.0.0.0" />
    </dependentAssembly>
    <dependentAssembly>
      <assemblyIdentity name="System.Runtime" publicKeyToken="b03f5f7f11d50a3a" culture="neutral" />
      <bindingRedirect oldVersion="0.0.0.0-4.0.20.0" newVersion="4.0.20.0" />
    </dependentAssembly>
    <!-- 可以根据日志里的其他冲突，添加更多类似的绑定重定向 -->
  </assemblyBinding>
</runtime>

按照这个顺序尝试，应该能解决链接器的空引用错误和版本冲突问题。

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