Swift 中使用 JSONEncoder 编码 Codable 模型时数组内对象序列化后为空
编码异常的根因与修复
核心直接原因
- 你定义的
D结构体将encode(to:)方法做了空实现,这是导致c数组内对象编码为空的唯一直接触发因素。 - 正常情况下如果没有手动写
encode(to:)方法,编译器会基于类型的存储属性自动合成对应的编码逻辑;但你手动实现了该方法且完全空实现后,会直接覆盖自动合成的逻辑,相当于执行编码操作时不对编码器写入任何内容。 - Codable协议的编码逻辑完全由类型自身实现的
encode(to:)方法决定:只要该方法没有把自身的l、m属性写入编码器容器,无论实例存储的属性值是什么、有没有西语特殊字符,最终编码输出的D对象都会是无键值对的空对象{}。 - 从你贴出的实际编码输出
{"a":"a","b":"b","c":[{}],"f":"f"}可以验证:PruebaModel自身的a、b、f字段都能正常编码输出,说明PruebaModel的编码逻辑没有问题,异常边界完全卡在D类型的编码实现上。
关于“特殊字符影响”的认知偏差
- 你感知到的“字符串无特殊字符时解码正常”的现象,和编码异常完全没有因果关系:解码和编码是两条独立的执行链路。
- 解码阶段走的是你为D、PruebaModel自定义实现的
init(from:)方法,这套逻辑能正确读取西语特殊字符、得到预期属性值,仅代表解码端逻辑正常。 - 你测试时遇到的编码输出空对象的情况,从最开始就和D实例的属性内容无关——哪怕D的属性是纯英文无特殊字符,只要
encode(to:)是空实现,输出的依然是空对象。你之所以会把两者关联,是因为没有直接针对编码逻辑做对照测试,误把不同链路的现象做了因果绑定。
修复方案
- 补全D结构体的
encode(to:)实现,按照自定义解码的字段映射规则,把自身的属性写入编码容器即可,示例代码:func encode(to encoder: Encoder) throws { var container = encoder.container(keyedBy: CodingKeys.self) try container.encode(l, forKey: .l) try container.encode(m, forKey: .m) } - 注意确保编码使用的
CodingKeys映射,和解码时使用的键名完全和目标JSON字段对齐,避免字段名不匹配导致的序列化错误。 - 补全实现后可重新编码验证:无论D的属性值是否包含西语特殊字符,都能正常输出对应键值对的JSON内容。如果后续仍遇到特殊字符序列化异常,再检查
JSONEncoder的转义配置即可,当前场景下该配置不影响结果。
内容的提问来源于stack exchange,提问作者Alejandro Gonzalez
相关产品推荐
相关产品推荐

