Rust中如何为IpNetwork实现Serde序列化与反序列化？

问题场景 #

我定义了包含IpNetwork字段的User结构体并派生Serialize/Deserialize，但编译报错：

依赖配置 #

[dependencies]
ipnetwork = "0.21.1"

代码实现 #

use ipnetwork::IpNetwork;
use serde::{Deserialize, Serialize};

#[derive(Serialize, Deserialize)]
pub struct User {
    // 其他字段
    pub reg_ip: Option<IpNetwork>,
}

错误信息 #

error[E0277]: the trait bound `IpNetwork: Deserialize<'_>` is not satisfied
    --> src\lib.rs:7:17
     |
7    |     pub reg_ip: Option<IpNetwork>,
     |                 ^^^^^^^^^^^^^^^^^ the trait `Deserialize<'_>` is not implemented for `IpNetwork`
     |
     = note: for local types consider adding `#[derive(serde::Deserialize)]` to your `IpNetwork` type
     = note: for types from other crates check whether the crate offers a `serde` feature flag
     = help: the following other types implement trait `Deserialize<'de>`:
               &'a Path
               &'a [u8]
               &'a str
               ()
               (T,)
               (T0, T1)
               (T0, T1, T2)
               (T0, T1, T2, T3)
             and 141 others
     = note: required for `std::option::Option<IpNetwork>` to implement `Deserialize<'_>`

解决方案 #

方法1：启用ipnetwork的serde特性（推荐） #

ipnetwork crate本身自带serde支持，只是默认未开启。修改Cargo.toml中的依赖配置，加上serde特性即可：

[dependencies]
ipnetwork = { version = "0.21.1", features = ["serde"] }

这样crate会自动为IpNetwork实现Serialize和Deserialize，不需要额外编写代码，直接就能正常序列化/反序列化。

方法2：手动实现Deserialize（无法修改依赖时） #

如果不能调整依赖配置，可以手动为IpNetwork实现反序列化逻辑。核心是先把JSON值反序列化为字符串，再解析成IpNetwork：

use ipnetwork::IpNetwork;
use serde::{Deserialize, Deserializer, Serialize};
use std::str::FromStr;

#[derive(Serialize, Deserialize)]
pub struct User {
    // 其他字段
    #[serde(deserialize_with = "deserialize_ipnetwork")]
    pub reg_ip: Option<IpNetwork>,
}

fn deserialize_ipnetwork<'de, D>(deserializer: D) -> Result<Option<IpNetwork>, D::Error>
where
    D: Deserializer<'de>,
{
    // 先反序列化为可选字符串
    let ip_str: Option<&str> = Option::deserialize(deserializer)?;
    
    match ip_str {
        None => Ok(None),
        Some(s) => {
            // 解析字符串为IpNetwork，失败时返回serde错误
            IpNetwork::from_str(s)
                .map(Some)
                .map_err(serde::de::Error::custom)
        }
    }
}

如果需要支持序列化，也可以添加serialize_with属性，实现对应的序列化函数，把IpNetwork转换成字符串输出。

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