Xamarin.Forms离线DB更新Azure时PATCH操作500错误调试求助

嘿，我之前调试Xamarin.Forms离线同步到Azure的问题时，也碰到过这种摸不着头脑的通用500错误，给你分享几个我当时踩过坑后总结的排查关键点：

• 确认[JsonIgnore]的正确性
  首先得确保你用的是Newtonsoft.Json.JsonIgnore特性（Azure Mobile Client默认依赖Newtonsoft.Json），别不小心用了System.Text.Json的同名特性。另外检查这个属性有没有同时标记其他序列化相关特性（比如[JsonProperty]），这些可能会覆盖[JsonIgnore]的效果。你可以手动序列化对象做测试：

  var json = JsonConvert.SerializeObject(yourProblemObject);
  Console.WriteLine(json);
  

  看看输出里有没有意外出现的虚拟字段，或者序列化过程中会不会抛出隐性异常。

• 深挖Azure端的详细日志
  虽然你说已经开启了日志，但可能还没拿到最底层的错误信息。试试：

  1. 在Azure Portal的Mobile App资源里，进入「诊断设置」，把日志级别调到「详细」，并确保勾选「应用程序日志」「Web服务器日志」等选项；
  2. 触发同步错误后，进入「日志分析」，用查询语句筛选更具体的错误，比如：

     AppServiceHTTPLogs | where StatusCode == 500 | project TimeGenerated, RequestUri, ScStatus, ScSubstatus, Message
     

  3. 如果你的Mobile App用的是.NET后端，还可以在Startup.cs里添加更细致的日志配置，把序列化、数据库操作的日志都打出来，方便定位完整堆栈。

• 检查导航/虚拟字段的加载逻辑
  既然问题表是唯一有虚拟计算或导航字段的表，哪怕加了[JsonIgnore]，也要注意：

  • 虚拟字段的getter有没有可能触发异常？比如计算时依赖了未加载的关联数据；
  • 导航属性是不是被懒加载了？同步时Azure Mobile Client可能会遍历对象属性，懒加载的导航属性如果加载失败，会导致整个序列化过程出问题。可以试试在同步前手动把导航属性设为null，再测试同步是否正常。

• 抓包查看同步请求的Payload
  用Fiddler或Charles抓一下同步时的HTTP请求，直接看发送到Azure的JSON内容。500错误很多时候是因为后端接收到的JSON格式不对、包含了数据库不支持的字段或值，抓包能直观看到问题所在，比日志更直接。

• 对比正常表的结构差异
  把出问题的表和其他能正常同步的表做全面对比：主键类型、字段数据类型（比如DateTime和DateTimeOffset的区别）、字段名称大小写（Azure SQL对大小写敏感）、有没有特殊约束等，这些细微差异都可能导致同步失败。

内容的提问来源于stack exchange，提问作者Pierre-D Savard