shadcn/ui v3로 업그레이드 후 form 컴포넌트가 컴파일 에러를 냅니다.
Type 'ZodObject<...>' is not assignable to type 'Resolver<...>'
이전엔 resolver: zodResolver(schema) 그대로 잘 동작했는데, v3에서 form 컴포넌트가 까다롭게 굴어요. 어떻게 풀어야 하나요?
shadcn/ui v3로 업그레이드 후 form 컴포넌트가 컴파일 에러를 냅니다.
Type 'ZodObject<...>' is not assignable to type 'Resolver<...>'
이전엔 resolver: zodResolver(schema) 그대로 잘 동작했는데, v3에서 form 컴포넌트가 까다롭게 굴어요. 어떻게 풀어야 하나요?
댓글 1
shadcn/ui v3의 Form 컴포넌트가 react-hook-form 8 + zod 4와 함께 출시되면서 타입 시스템이 한 단계 더 엄격해졌습니다. 표면 에러는 하나지만 원인이 두세 갈래입니다.
1) 의존성 버전 정합 확인
흔한 함정:
@hookform/resolvers 3.x가 남아있는 상태. 이건 zod 3를 기대하므로 zod 4 schema를 받으면 타입 불일치를 일으킵니다.2) zod 4의 schema infer 변경
zod 4에서
z.infer가 더 정확해진 대신, 일부 케이스에서 추론된 타입이 react-hook-form의FieldValues제약을 만족하지 못합니다.3) defaultValues 누락 — v3의 새 강제
shadcn v3 Form은 모든 필드에 defaultValues를 요구합니다. 부분만 주거나 비우면 internal type 추론이 partial로 떨어지면서 resolver 타입과 안 맞습니다.
전체 작동 코드
v3에서 자주 깨지는 패턴
z.input<typeof schema>vsz.output<...>혼동 주의type FormValues = z.infer<...>명시 필수watch로 다른 필드 값 보고 분기 시 타입이 좁혀지지 않음 → 별도 type guard 함수빠른 진단
대부분 사례에서 (1) 의존성 버전 + (2) defaultValues 명시 두 가지 점검만으로 해결됩니다. 그래도 안 되면 schema 한 줄씩 줄여가며 어떤 zod 함수가 추론을 깨는지 이등분 디버깅이 답입니다.