Maui Hybrid Android发布模式崩溃，报错protocol message contained an invalid tag (zero)

常见修复方案 #

1. 调整Linker配置 #

Release模式默认启用的Linker可能误删Protobuf相关依赖，导致序列化异常：

• 打开项目.csproj文件，添加Release专属配置：

<PropertyGroup Condition="'$(Configuration)' == 'Release'">
  <LinkerDescriptor>LinkerConfig.xml</LinkerDescriptor>
</PropertyGroup>

• 新建LinkerConfig.xml，保留关键程序集：

<linker>
  <assembly fullname="Google.Protobuf" preserve="all"/>
  <assembly fullname="你的应用程序集名称" preserve="all"/> <!-- 替换为实际应用名称 -->
</linker>

也可以直接在项目属性的对应平台选项（如Windows Options）里，把Linker行为设为Sdk Only，避免过度优化。

2. 校验Protobuf相关文件 #

如果用了Protobuf做数据传输，排查定义文件和生成代码：

• 确保Google.Protobuf NuGet包版本与Protobuf工具版本匹配；
• 重新生成Protobuf代码，清理项目后再构建Release版本。

3. 修复Windows平台兼容性问题 #

Visual Studio 17.3.4 + .NET 6的MAUI Release模式存在已知兼容问题：

• 升级Visual Studio到17.4及以上版本，或更新.NET 6至最新补丁；
• 关闭项目属性中Windows平台的“Compile with .NET Native tool chain”选项，该选项可能引发类型序列化错误。

4. 开启Release模式调试定位 #

获取精准崩溃信息：

• 在项目Build选项卡的Release模式下，勾选“Debug symbols”（选pdb-only即可）；
• 部署Release版本后附加调试器，查看崩溃代码位置，确认是否是特定序列化操作触发错误。

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