멀쩡해 보이는 JSON이 첫 글자에서 오류를 내는 이유
JSON 객체가 정상으로 보이는데도 위치 0에서 오류가 날 수 있습니다. 눈에 보이는 여는 중괄호 앞에 보이지 않는 U+FEFF 문자가 들어 있을 수 있기 때문입니다. 수정하기 전에 원본부터 보관하세요. 응답이 HTML 로그인 페이지이거나 비어 있거나 잘못된 문자 인코딩으로 읽힌 경우에는 전혀 다른 해결책이 필요합니다.
2017년 Stack Overflow에는 Node.js의 비슷한 오류를 조사하다 십진수 65279, 즉 U+FEFF를 발견한 사례가 올라왔습니다. 이 글에 보관된 브라우저 시험은 그 사례와 별개입니다. 직접 만든 U+FEFF 접두 문자 뒤에 {"ok":true}를 붙였을 때 파싱에 실패했고, 맨 앞 문자만 제거하자 성공했습니다. 캡처는 해당 사용자의 파일이 아니라 이 로컬 시험을 기록한 것입니다.
원본을 지키면서 직접 적용하는 수정 방법
유일한 원본을 수정하지 말고 파일 복사본에서 시작하세요. 웹 요청으로 받은 데이터라면 먼저 HTTP 상태와 콘텐츠 유형을 확인합니다. <!doctype html>로 시작하는 로그인 페이지에는 JSON 정리가 아니라 인증 문제 해결이 필요합니다. 로컬 파일은 인코딩을 표시할 수 있는 편집기로 열고, 조사 중에는 원본을 덮어쓰지 마세요.
파일을 JavaScript 문자열 text로 읽은 다음, 자신의 가져오기 스크립트에서 아래 함수를 사용할 수 있습니다. 확인된 선행 표식 하나만 제거하고 나머지는 그대로 둡니다.
function parseJsonText(text) {
if (typeof text !== "string") throw new TypeError("Expected text");
const hadBOM = text.charCodeAt(0) === 0xFEFF;
const cleaned = hadBOM ? text.slice(1) : text;
return { value: JSON.parse(cleaned), removedLeadingBOM: hadBOM };
}
const sample = '\uFEFF{"ok":true,"name":"한글"}';
const result = parseJsonText(sample);
console.log(result.removedLeadingBOM); // true
console.log(result.value.ok); // true
console.log(result.value.name); // 한글오류 메시지가 사라졌다는 사실만으로 성공을 판단하지 마세요. 기대한 속성이 존재하는지, 한글 등 비영어 문자가 제대로 남아 있는지 확인합니다. 일반 JSON도 시험해 보세요. 표식을 제거했다고 보고하지 않으면서 정상 파싱되어야 합니다. 빈 입력이나 잘못된 객체는 여전히 오류가 나야 합니다. 실패를 빈 객체로 바꾸면 정상 데이터로 오인할 수 있으므로 호출한 쪽에서 오류를 확인할 수 있게 두세요.
첫 코드 포인트가 U+FEFF가 아니라면 이 제거 방법을 중단하세요. 잘못된 인코딩으로 읽은 파일에는 대체 문자나 번갈아 나타나는 널 문자가 있을 수 있습니다. 내보내기 프로그램이 사용한 인코딩으로 다시 열거나 UTF-8로 새로 내보내 달라고 요청하세요. 잘못 해석한 바이트는 문자를 지운다고 복구되지 않습니다.
바이트와 보이지 않는 문자는 다릅니다
TextDecoder("utf-8")는 일반적으로 맨 앞 UTF-8 BOM을 생략합니다. ignoreBOM 옵션은 이름만 보고 판단하기 쉽지 않습니다. true를 주면 오히려 표식이 디코딩된 문자열에 포함됩니다. 시험용 바이트 EF BB BF 7B 7D는 기본 동작에서 {}가 됐습니다. 이것은 인코딩을 자동으로 판별한다는 뜻이 아닙니다.
파일을 만든 쪽도 확인하세요
별도의 PowerShell 사례에서는 잘못된 디코딩 경로가 문제였습니다. Windows PowerShell의 Out-File과 리디렉션은 UTF-16LE를 만들 수 있고, 최신 PowerShell은 동작이 다릅니다. 비ASCII 문자를 무조건 지우면 인코딩 불일치는 해결하지 못한 채 정상 이름만 손상될 수 있습니다. 파일을 만든 명령과 버전을 확인하고 올바르게 읽거나 다시 내보내세요. 이 글의 시험에서 해당 사용자의 전체 작업 과정을 재현한 것은 아닙니다.
RFC 8259는 닫힌 시스템 바깥에서 교환하는 JSON에 UTF-8을 요구하며, 전송하는 쪽에서 네트워크 JSON에 BOM을 추가하지 못하도록 규정합니다. 가능하면 내보내기 프로그램을 수정하세요. 가져오기 경계에서는 일반 JSON, 확인된 접두 문자, 잘못된 JSON, 비영어 값까지 시험합니다. 로그에는 진단에 필요한 접두 정보만 남기고 개인 문서 내용은 기록하지 마세요.
