Rust共享库backend特性下结构体成员条件序列化编译错误排查

安全阿岳

2026-7-7

解决方案

问题核心是非backend特性下，serde_as的序列化规则未正确覆盖chrono::Duration的默认反序列化要求，或是依赖特性配置不全。以下是具体修复步骤：

1. 确认依赖配置

在shared crate的Cargo.toml中，确保chrono启用serde特性，同时引入serde_with（serde_as属于该库）：

[dependencies]
serde = { version = "1.0", features = ["derive"] }
serde_with = "3.0"
chrono = { version = "0.4", features = ["serde", "std"] }
# Scylla依赖仅在backend特性下启用
scylla = { version = "0.11", features = ["derive"], optional = true }

2. 修正结构体条件编译写法

在shared/cart_items.rs中，用cfg_attr精准控制不同特性下的序列化规则，确保serde_as在非backend模式下生效：

use serde::{Deserialize, Serialize};
use serde_with::serde_as;

#[derive(Debug, Serialize, Deserialize)]
#[cfg_attr(not(feature = "backend"), serde_as)]
pub struct CartItem {
    // 其他字段...
    #[cfg_attr(feature = "backend", serde(with = "crate::TimestampDef"))]
    #[cfg_attr(not(feature = "backend"), serde_as(as = "serde_with::DurationSeconds<i64>"))]
    pub timestamp: 
        #[cfg(feature = "backend")] scylla::frame::value::Timestamp,
        #[cfg(not(feature = "backend"))] chrono::Duration,
}

3. 关键细节说明

必须给CartItem结构体添加#[cfg_attr(not(feature = "backend"), serde_as)]，因为serde_as宏需要标记在结构体上才能识别字段级的序列化规则。
chrono::Duration默认未实现Deserialize，必须通过serde_with的DurationSeconds<i64>提供序列化/反序列化逻辑。
字段类型分支用#[cfg]单独标注，确保不同特性下类型正确切换，序列化规则通过#[cfg_attr]绑定对应特性。