본문으로 건너뛰기
FrAIFlow

Solutions

JSON을 읽었을 뿐인데 ID 숫자가 달라지는 이유

긴 JSON 식별자는 포매터가 화면에 보여주기도 전에 바뀔 수 있습니다. JavaScript Number는 9007199254740991보다 큰 모든 정수를 정확하게 표현하지 못합니다. 식별자가 이 자료형을 거치면 보기 좋게 정리된 출력에도 이미 다른 숫자가 들어 있을 수 있습니다.

공개 사례에는 JSON.parse가 큰 숫자를 바꾸거나 Google Apps Script에서 정밀도가 손실되는 문제가 있습니다. 저장된 Node.js 시험에서는 숫자 9007199254740993을 읽자 9007199254740992가 됐고, 따옴표로 묶은 문자열은 모든 자릿수를 유지했습니다. 통제된 시험 결과이며 실제 API나 현재 FrAIFlow 포매터를 시험한 것은 아닙니다.

출력 형식을 꾸미기 전에 자료형 경계를 고치세요

응답의 주문 ID 끝자리는 993인데 가져온 뒤 992가 됐다고 해 보겠습니다. 먼저 손대지 않은 원응답과 파싱된 객체를 비교하세요. 예쁘게 출력하는 도구로 이미 반올림된 값을 복원할 수는 없습니다. 원응답 파일을 보관하고, 조사하는 동안 다른 숫자 가져오기 도구로 열어 다시 저장하지 마세요.

const numeric = JSON.parse('{"id":9007199254740993}');
const exact = JSON.parse('{"id":"9007199254740993"}');
console.log(numeric.id); // 9007199254740992
console.log(exact.id);   // 9007199254740993
console.log(typeof exact.id); // string

식별자라면 보통 두 번째, 문자열 표현이 유용합니다. API 제공자에게 ID를 따옴표로 묶어 달라고 요청한 뒤 사용하는 모든 지점을 확인하세요. 뒤에서 Number(id)를 호출하거나 스프레드시트로 가져오면 다시 손실될 수 있습니다. 숫자로만 이루어진 고객 코드도 계산할 수량과는 다릅니다.

제공자가 바꿀 수 없다면 먼저 파싱한 뒤 복구하려 하지 마세요. 지원되는 런타임에서는 원문을 읽을 수 있는 reviver로 원래 토큰을 가져올 수 있습니다. 아래 예시는 의도적으로 id 필드만 처리합니다. 모든 숫자를 일괄 변환하지 말고 자신의 스키마에 맞추세요.

let supportsSource = false;
JSON.parse("1", (key, value, context) => {
  supportsSource = context?.source === "1";
  return value;
});
if (!supportsSource) throw new Error("Use a lossless JSON parser");
const record = JSON.parse('{"id":9007199254740993}',
  (key, value, context) => {
    if (key === "id" && typeof value === "number") {
      if (!context || !/^-?\d+$/.test(context.source)) {
        throw new Error("Expected a decimal integer ID");
      }
      return context.source; // Keep the exact token as a string.
    }
    return value;
  });
console.log(record.id === "9007199254740993"); // true

안전한 정수 경계 바로 아래와 바로 위 값을 시험하고, 예시를 내보낸 뒤 다시 읽어 보세요. 모든 자릿수가 원본과 같아야 합니다. 식별이 아니라 계산이 필요하다면 BigInt나 decimal 전략을 명확하게 정하고 직렬화 방법도 결정하세요. 이미 반올림된 Number를 BigInt로 바꿨다고 잃어버린 정밀도가 돌아오는 것은 아닙니다.

숫자 변환에서 사라질 수 있는 정보

일반적인 reviver는 파싱이 끝난 Number를 받으므로 잃어버린 자릿수를 복구하기에는 늦습니다. 위의 원문 접근 방식은 런타임 지원과 필드 스키마에 의존합니다. 지원되지 않으면 토큰을 보존하는 파서를 선택하세요. 광범위한 정규식으로 숫자에 따옴표를 씌우면 이미 문자열 안에 있던 내용이나 실제 숫자여야 하는 필드까지 바꿀 수 있습니다.

숫자 JSON 토큰 / 9007199254740993 / 파싱 결과: 9007199254740992
직접 제작한 설명 이미지입니다. 실제 프로그램 화면 캡처가 아닙니다.

계산용 BigInt는 이미 반올림된 Number가 아니라 원래 십진수 문자열에서 만드세요. 직렬화도 미리 정해야 합니다. 일반 JSON.stringify는 BigInt 값을 직접 직렬화하지 않습니다. 표시 형식을 바꾸거나 뒤에 0을 붙여도 원래 식별자를 복원할 수 없습니다.

JSON의 숫자 ID 9007199254740993은 9007199254740992로 바뀌지만 문자열 ID는 유지되는 비교
직접 제작한 설명 이미지입니다. 실제 프로그램 화면 캡처가 아닙니다.
저장된 시험 기록: JSON의 숫자 ID 9007199254740993은 9007199254740992로 바뀌지만 문자열 ID는 유지되는 비교
저장된 로컬 시험 결과입니다. 이미지를 열면 원본 증거를 자세히 볼 수 있습니다.
출처, 실제 사례 및 참고 자료