Pydantic alias와 extra 충돌: 검증값과 JSON 출력의 우선권
추가 입력을 허용하는 선택이 검증된 값의 우선권까지 바꾸지 않도록 충돌 처리 계약이 필요하다.
Pydantic alias와 extra 충돌: 검증값과 JSON 출력의 우선권
모델 검증을 통과한 필드값이 그대로 응답에 쓰인다는 가정은 alias와 extra 키가 충돌하면 다시 확인해야 한다. 출력 방식에 따라 값이 덮어써지거나 중복 키가 생기면 소비자마다 다른 결과를 볼 수 있다. 검증 단계와 직렬화 단계 사이에 명시적인 우선권 계약이 필요하다. [1, 2, 3]
공개 원문이 보여 준 범위
extra=allow인 Pydantic 모델에 alias와 필드 이름을 동시에 전달하면 검증된 필드값과 model_extra가 충돌한다는 보고다. dict 출력의 덮어쓰기와 JSON의 중복 키 출력을 구별했다. [1]
입력과 출력에서 확인할 관계
alias 입력과 extra 필드의 출처를 분리해 보관한다. 충돌한 응답은 애플리케이션이 어느 값을 권위 있는 값으로 사용할지 정하기 전까지 전달하지 않는다. canonical_field, validated_value, serialized_value, extra_key를 대사하되 원시 JSON의 중복 키는 일반 dictionary로 읽기 전에 확인해야 한다. 이미 덮어쓴 값만 남으면 충돌 이력을 되찾기 어렵다. [1, 3]
승인 기준과 실패 사례
설명용 입력 X=1과 x=2에서 alias X를 선언 필드로 선택했다면 승인 출력값은 1이다. 직렬화 결과가 1을 유지하면 이 선택을 따르지만 extra 값 2로 바뀌면 계약을 어긴다. extra 입력을 별도로 처리하거나 충돌 자체를 거절하는 정책도 가능하다. 어느 선택이든 출력이 우연히 정한 우선권이 아니라 명시적으로 승인한 규칙이어야 한다. [1, 3]
Truthound를 연결하는 검사 경계
Truthound Core 3.3.2의 ColumnPairValidator는 검증값과 직렬화 후 선택된 값을 대조할 수 있다. 원시 JSON의 중복 키는 그보다 앞에서 검사해야 하며, 일반 dictionary로 파싱해 마지막 값만 남긴 후에는 이력을 되살릴 수 없다. 별칭 우선권은 모델 호출자가 정한다. [1, 2, 3]
다른 선택이 필요한 조건
표로 파싱한 뒤에는 JSON 중복 키가 이미 소실될 수 있으므로 원시 JSON의 키 중복 검사가 별도로 필요하다. 충돌하는 alias·필드명 조합을 수신 경계에서 거절하거나 extra 정책을 제한한다. 업무 계약이 추가값 우선 덮어쓰기를 명시했다면 검증값 우선 규칙 자체를 바꿔야 한다. [1, 3]
적용 조건
canonical_field, validated_value, serialized_value, extra_key 원장을 원시 입력과 승인 기준에서 각각 준비하고 행 식별자를 유지한다.
대안
충돌하는 alias·필드명 조합을 수신 경계에서 거절하거나 extra 정책을 제한한다.
한계
표로 파싱한 뒤에는 JSON 중복 키가 이미 소실될 수 있으므로 원시 JSON의 키 중복 검사가 별도로 필요하다.
근거
- 사건 확인일
- 대상 확인일
- 수정일
