“TypeScript를 쓰는데도 Zod가 필요한 이유
작성자: 관리자A · 게시판: 자유게시판 · 2026-08-03 17:54 · 추천 1 · 댓글 0
최근 “Zod Makes TypeScript Even Better”라는 영상을 보고, TypeScript와 Zod를 같이 사용하는 이유를 정리해봤습니다.
처음에는 이런 생각이 들었습니다.
TypeScript로 타입을 지정하고 서버에서 if문으로 검사하면 되는데, 굳이 Zod가 필요한가?
결론부터 말하면 직접 검증 코드를 잘 작성한다면 Zod는 필수가 아닙니다.
하지만 TypeScript의 타입과 실제 데이터 검증은 역할이 다릅니다.
TypeScript 타입은 실행할 때 사라진다
회원가입 요청 데이터를 다음처럼 정의했다고 해보겠습니다.
type SignupBody = {
email: string;
password: string;
age: number;
};
const body: SignupBody = req.body;
코드상으로는 email이 문자열이고 age가 숫자인 것처럼 보입니다.
하지만 TypeScript는 JavaScript로 변환될 때 타입 정보가 제거됩니다.
const body = req.body;
즉, SignupBody라고 적었다고 해서 서버가 실제로 다음을 검사하는 것은 아닙니다.
email이 정말 문자열인가?
password가 정말 문자열인가?
age가 정말 숫자인가?
TypeScript는 개발자가 코드를 작성할 때 타입 오류를 잡아주지만, HTTP 요청으로 들어온 실제 JSON 데이터까지 자동으로 검사하지는 않습니다.
클라이언트 폼만 믿으면 안 되는 이유
일반 사용자는 회원가입 폼을 통해 요청을 보내지만, Postman이나 curl을 사용하면 서버 API에 직접 요청할 수 있습니다.
curl -X POST https://example.com/signup \
-H "Content-Type: application/json" \
-d '{
"email": 123,
"password": null,
"age": "스물다섯"
}'
서버에 실제 검증 로직이 없다면 이런 잘못된 값도 들어올 수 있습니다.
const email = body.email.toLowerCase();
TypeScript는 email을 문자열로 알고 있지만, 실제 값이 숫자라면 런타임 오류가 발생합니다.
TypeError: body.email.toLowerCase is not a function
Zod를 사용하면
Zod는 서버가 실행되는 중에 실제 값을 검사합니다.
import { z } from "zod";
const SignupSchema = z.object({
email: z.string().trim().email(),
password: z.string().min(8),
age: z.number().int().min(14),
});
회원가입 요청이 들어오는 지점에서 검사합니다.
app.post("/signup", async (req, res) => {
const result = SignupSchema.safeParse(req.body);
if (!result.success) {
return res.status(400).json({
message: "회원가입 정보가 올바르지 않습니다.",
});
}
const signupData = result.data;
await signupService.create(signupData);
return res.status(201).json({
message: "회원가입이 완료되었습니다.",
});
});
잘못된 값은 서비스나 DB로 넘어가기 전에 차단되고, 검증을 통과한 데이터만 사용할 수 있습니다.
Zod의 핵심 장점
Zod는 검증뿐만 아니라 TypeScript 타입도 자동으로 만들 수 있습니다.
const SignupSchema = z.object({
email: z.string().email(),
password: z.string().min(8),
age: z.number().int().min(14),
});
type SignupBody = z.infer<typeof SignupSchema>;
스키마 하나로 두 가지를 처리할 수 있습니다.
실행 중 실제 데이터 검증
개발 중 TypeScript 타입 제공
타입과 검증 코드를 따로 작성하면 둘 중 하나만 수정하는 실수가 생길 수 있지만, Zod를 사용하면 하나의 스키마를 기준으로 관리할 수 있습니다.
또한 검증과 동시에 값을 정리하거나 변환할 수도 있습니다.
const UserSchema = z.object({
email: z.string().trim().toLowerCase().email(),
age: z.coerce.number().int().positive(),
});
UserSchema.parse({
email: " USER@EXAMPLE.COM ",
age: "25",
});
결과:
{
email: "user@example.com",
age: 25,
}
Zod는 어디에서 사용할까?
Zod는 보통 외부 데이터가 프로그램 안으로 들어오는 지점에서 사용합니다.
HTTP 요청 body
URL query parameter
외부 API 응답
환경변수
JSON 파일
폼 입력값
서버 기준으로는 보통 다음 흐름입니다.
클라이언트 요청
↓
Controller 또는 Router
↓
Zod 검증
↓
Service
↓
Database
모든 함수에서 반복해서 검사하는 것이 아니라, 외부 데이터가 들어오는 입구에서 한 번 검증하고 이후 내부 로직에서는 TypeScript 타입을 활용하면 됩니다.
정리
TypeScript
→ 개발 단계의 정적 타입 검사
→ 타입 정보는 JavaScript 변환 과정에서 사라짐
Zod
→ 실행 중 실제 데이터 검사
→ 검증 결과에서 TypeScript 타입 추론 가능
둘은 서로 대체하는 관계가 아닙니다.
TypeScript는 코드 안에서 타입을 안전하게 사용하도록 도와주고, Zod는 코드 밖에서 들어온 데이터가 실제로 그 타입과 일치하는지 확인해줍니다.
직접 if문으로 검사할 수도 있지만, Zod를 사용하면 검증 규칙을 간결하게 작성하고 TypeScript 타입과 함께 관리할 수 있다는 점이 큰 장점입니다.