Rust serde 枚举如何配置未知值归入兜底分支
问题说明
需要实现的枚举映射逻辑为:
- 反序列化流程遇到无法匹配已知明确分支的内容时,自动将该内容关联到枚举的最后一个兜底分支
- 已知分支序列化时需要输出对应的字面量字符串,而非空值
初始错误实现
按照最初思路编写的枚举结构及测试代码,实际运行时会出现已知枚举值序列化输出为null、完全无法触发兜底分支的问题:
错误的枚举定义:
#[derive(Serialize, Deserialize, Clone, Debug)] #[serde(untagged)] pub enum Action { Action1, Action2, Action3, Other(String), // 兜底分支:未匹配已知值时存入此处 }
测试代码:
let b = Action::Action1; let s = serde_json::to_string(&b); let ss = s.unwrap(); println!("ss {:#?}", &ss); let val = serde_json::to_value(b); println!("ss {:#?}", &val);
根因分析
出现异常的核心原因有两个:
- 错误使用
#[serde(untagged)]属性untagged的设计场景是枚举分支对应完全异构的JSON结构——比如一个分支对应数字、一个对应字符串、一个对应嵌套对象,serde会自动按JSON值的结构从上到下匹配对应分支。
但在当前需求里,所有分支对应的都是普通字符串类型的JSON值,属于典型的固定字符串映射枚举,完全不需要untagged。强行加上untagged后,没有附带任何数据的单元变体(比如Action1)会被serde识别为序列化后输出null的空类型,根本不会把变体名作为字符串值输出,这就是序列化结果为null的直接原因。 - 缺失兜底匹配标记
仅把兜底的Other(String)分支放在枚举最后、没有任何标记的话,serde不会主动把未匹配到已知分支的值传给这个分支。加上untagged模式后,前面三个无数据的单元变体没有任何结构约束,会错误匹配任意类型的输入值,导致就算碰到未知的字符串内容,也永远走不到最后的兜底分支。
正确实现方案
调整枚举定义,移除不需要的untagged属性,为字符串表示添加统一的重命名规则,同时给兜底分支加上serde内置的未知值匹配标记即可:
#[derive(Serialize, Deserialize, Clone, Debug)] // 自动按变体名的PascalCase规则映射序列化/反序列化的字符串值 #[serde(rename_all = "PascalCase")] pub enum Action { Action1, Action2, Action3, // 标记为兜底分支,自动接收所有未匹配前面几个已知值的字符串内容 #[serde(other)] Other(String), }
实现后可完全满足需求:
- 序列化
Action::Action1时,会输出符合预期的JSON字符串"Action1",不再输出null - 反序列化时,碰到
"Action2"会匹配到对应已知分支;碰到任何未定义的字符串值(比如"custom_action"),会自动生成Action::Other("custom_action".to_string())实例,全程不需要手写自定义反序列化逻辑。
注意事项:
#[serde(other)]标记的兜底分支,在同一个枚举里只能出现一次,且仅支持字符串、数字这类基础值类型的匹配兜底。
内容的提问来源于stack exchange,提问作者Avba
相关产品推荐
相关产品推荐

