JSON 예시를 serde로 (역)직렬화할 수 있는 Rust struct로 바꿉니다. 모든 struct에 #[derive(Debug, Clone, Serialize, Deserialize)]가 붙고, 필드 이름은 Rust 관례인 snake_case로 맞춘 뒤 원래 키가 다르면 #[serde(rename)]으로 연결합니다.
reqwest로 받은 API 응답을 타입으로 받고 싶을 때, axum·actix-web 핸들러의 Json<T> 추출기에 넣을 요청 타입이 필요할 때, 로그·이벤트 JSON을 파싱하는 CLI 도구를 만들 때 출발점으로 쓸 수 있습니다.
타입 이름에 최상위 struct 이름을 적습니다(예: AccessLog)..rs 파일에 붙여넣고, Cargo.toml에 serde(derive 기능)와 serde_json을 추가합니다.serde_json::from_str::<AccessLog>(&body)? 또는 resp.json::<AccessLog>().await?로 사용합니다.{
"timestamp": 1714550400,
"level": "warn",
"type": "http_request",
"status": 503,
"latency_ms": 1250.7,
"headers": [{ "name": "user-agent", "value": "curl/8.4" }],
"trace_id": null
}use serde::{Deserialize, Serialize};
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct AccessLog {
pub timestamp: i64,
pub level: String,
#[serde(rename = "type")]
pub type_: String,
pub status: i64,
pub latency_ms: f64,
pub headers: Vec<Header>,
pub trace_id: serde_json::Value,
}
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Header {
pub name: String,
pub value: String,
}
type은 Rust 키워드라 type_ 필드에 #[serde(rename = "type")]가 붙었습니다. 정수는 범위와 관계없이 i64, latency_ms는 f64입니다. 값이 null뿐인 trace_id는 타입을 알 수 없어 serde_json::Value로 남았으니 실제 타입(예: Option<String>)으로 바꿔 주세요.
#[derive(Debug, Clone, Serialize, Deserialize)]와 pub 필드.#[serde(rename = "원래키")].Option<T>와 #[serde(default, skip_serializing_if = "Option::is_none")].null이 섞인 필드: 어트리뷰트 없이 Option<T>.i64, 소수 f64, bool, String, 배열 Vec<T>, 타입이 섞인 값은 serde_json::Value.type, match, ref 같은 키워드 키는 type_처럼 _를 붙입니다.pub type Root = Vec<RootItem>; 별칭을 만듭니다.serde_json::Value에서 ["status"].as_i64()로 꺼내던 코드를 resp.json::<AccessLog>()로 바꾸면 필드 오타가 컴파일 단계에서 걸립니다.
클라이언트가 보내는 JSON 예시로 struct를 만들어 Json(payload): Json<CreateOrder>로 받으면, 필드가 빠졌거나 타입이 틀린 요청은 핸들러 코드가 실행되기 전에 프레임워크가 오류 응답으로 돌려보냅니다.
로그 한 줄을 넣어 만든 struct로 BufReader::lines()를 돌며 역직렬화하면, 필드별 집계 도구를 몇 줄로 만들 수 있습니다.
i64입니다. u16 상태 코드나 u32 카운트처럼 범위가 정해져 있다면 직접 좁혀 주세요.i64·String 그대로입니다. chrono나 time 크레이트 타입으로 바꾸려면 해당 크레이트의 serde 기능을 켜야 합니다.serde_json::Value를 쓰는 출력은 use serde_json 없이 전체 경로로 적혀 있어 import는 필요 없지만 serde_json 의존성은 있어야 합니다.#[serde(rename_all = "camelCase")] 같은 struct 단위 어트리뷰트 대신 필드별 rename을 씁니다. 키 표기가 일정하다면 직접 묶어도 됩니다."level": "warn"처럼 값이 정해진 필드는 생성 후 enum으로 바꾸는 것을 고려하세요.#[serde(default)]가 왜 함께 붙나요?serde는 Option 필드가 없을 때 None으로 채우지만, default를 명시해 두면 나중에 타입을 Vec<T> 등 비 Option으로 바꿔도 키가 빠진 입력을 받아들입니다. skip_serializing_if는 다시 JSON으로 쓸 때 None 필드를 생략해 원본 모양을 유지합니다.
null이 섞인 필드와 아예 없는 필드는 어떻게 다르게 나오나요?둘 다 Option<T>지만, 키가 빠지는 필드만 default·skip_serializing_if 어트리뷰트를 받습니다. 항상 키가 있고 값만 null인 필드는 직렬화할 때도 null로 다시 써집니다.
Deserialize<'de> 수명이나 &str 필드를 쓰지 않나요?제로 카피 역직렬화(&'a str)는 입력 버퍼보다 오래 살 수 없어서 일반적인 응답 처리에는 불편합니다. 기본은 소유 타입 String이고, 성능이 중요하면 필요한 필드만 Cow<'a, str> 등으로 바꾸면 됩니다.
Default나 PartialEq derive도 추가할 수 있나요?출력에는 Debug, Clone, Serialize, Deserialize만 들어갑니다. 필드 타입이 모두 지원한다면 derive 목록에 직접 추가하면 됩니다(serde_json::Value는 PartialEq를 지원).