Xamarin sqlite-net-pcl使用struct作为表数据类型时读取数据异常

sqlite-net-pcl 确实不支持使用 struct 作为数据表的映射类型，该限制属于库的设计特性，没有在官方文档中明确标注。

问题原因 #

• 反序列化逻辑未适配值类型：库读取数据的核心逻辑默认针对引用类型实现，会先通过Activator.CreateInstance生成目标类型的空实例，再通过反射或预生成的委托为实例属性赋值。当目标类型是struct（值类型）时，创建出的实例会被装箱为object对象，后续属性赋值操作作用于装箱后的副本，无法完成对值类型实例的写入，库内部没有针对值类型做特殊适配，因此触发System.ArgumentException: method arguments are incompatible异常。
• 建表、插入操作正常的逻辑：建表仅需要读取类型的元数据和属性标签，插入操作仅需要读取实例的属性值，这两类操作的反射逻辑对值类型和引用类型通用，因此不会出现报错。

解决方案 #

1. 优先使用class作为映射类型：这是sqlite-net-pcl的标准使用方式，将struct改为class的方案完全符合库的设计要求，不存在额外性能或功能缺陷。同时带有可变属性、用于数据持久化的场景本身也不符合struct的最佳实践（struct适合作为小尺寸、不可变的值载体）。
2. 如果必须使用struct存储数据，可以绕过库的内置泛型反序列化逻辑：先执行非泛型查询获取原始数据行，再手动将字段值赋值给struct实例。

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