LLM 커뮤니티 › 자유게시판

“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>;

스키마 하나로 두 가지를 처리할 수 있습니다.

타입과 검증 코드를 따로 작성하면 둘 중 하나만 수정하는 실수가 생길 수 있지만, 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는 보통 외부 데이터가 프로그램 안으로 들어오는 지점에서 사용합니다.

서버 기준으로는 보통 다음 흐름입니다.

클라이언트 요청
    ↓
Controller 또는 Router
    ↓
Zod 검증
    ↓
Service
    ↓
Database

모든 함수에서 반복해서 검사하는 것이 아니라, 외부 데이터가 들어오는 입구에서 한 번 검증하고 이후 내부 로직에서는 TypeScript 타입을 활용하면 됩니다.

정리

TypeScript
→ 개발 단계의 정적 타입 검사
→ 타입 정보는 JavaScript 변환 과정에서 사라짐

Zod
→ 실행 중 실제 데이터 검사
→ 검증 결과에서 TypeScript 타입 추론 가능

둘은 서로 대체하는 관계가 아닙니다.

TypeScript는 코드 안에서 타입을 안전하게 사용하도록 도와주고, Zod는 코드 밖에서 들어온 데이터가 실제로 그 타입과 일치하는지 확인해줍니다.

직접 if문으로 검사할 수도 있지만, Zod를 사용하면 검증 규칙을 간결하게 작성하고 TypeScript 타입과 함께 관리할 수 있다는 점이 큰 장점입니다.

댓글 0개

아직 댓글이 없어요.

자유게시판의 다른 글