파서 오류, 웹훅(Webhook) 서명 불일치, SQL 조회 실패는 터미널 에뮬레이터나 코드 에디터에서 똑같이 렌더링되거나 아예 눈에 보이지 않는 문자 때문에 발생하는 경우가 많습니다. 문서 포털이나 메신저에서 복사한 환경 변수가 화면상으로는 api_key=prod와 완전히 똑같아 보이는 다음 사례를 살펴보겠습니다.
Visual rendering: api_key=prod
String.length: 14 (expected 12)
UTF-8 byte length: 19 bytes (expected 12 bytes)
이 길이 14짜리 문자열을 유니코드 문자 검사기에 넣으면 평범한 ASCII 텍스트처럼 보이던 문자열 속에 숨어 있던 세 가지 이상 징후가 드러납니다. 맨 앞의 바이트 순서 표시(<BOM>), 라틴 문자 a를 대체한 키릴 문자 호모글리프, 그리고 중간에 삽입된 제로 너비 공백(<ZWSP>)입니다.
[
{
"index": 0,
"badge": "<BOM>",
"codePoint": "U+FEFF",
"name": "ZERO WIDTH NO-BREAK SPACE",
"category": "Cf (Format)",
"block": "Arabic Presentation Forms-B",
"utf8Hex": "EF BB BF",
"utf16BE": "FE FF",
"utf16LE": "FF FE",
"warning": "Invisible zero-width format character"
},
{
"index": 1,
"glyph": "а",
"codePoint": "U+0430",
"name": "CYRILLIC SMALL LETTER A",
"category": "Ll (Lowercase Letter)",
"block": "Cyrillic",
"utf8Hex": "D0 B0",
"utf16BE": "04 30",
"utf16LE": "30 04",
"warning": "Confusable homoglyph for Latin U+0061 ('a')"
},
{
"index": 2,
"glyph": "p",
"codePoint": "U+0070",
"name": "LATIN SMALL LETTER P",
"category": "Ll (Lowercase Letter)",
"block": "Basic Latin",
"utf8Hex": "70",
"utf16BE": "00 70",
"utf16LE": "70 00",
"warning": null
},
{
"index": 8,
"badge": "<ZWSP>",
"codePoint": "U+200B",
"name": "ZERO WIDTH SPACE",
"category": "Cf (Format)",
"block": "General Punctuation",
"utf8Hex": "E2 80 8B",
"utf16BE": "20 0B",
"utf16LE": "0B 20",
"warning": "Invisible zero-width format character"
}
]
또한 다중 코드 포인트 이모지가 런타임마다 전혀 다른 문자열 길이를 반환하는 이유도 명확히 확인할 수 있습니다. 화면에는 한 글자로 보이는 기술자 이모지 👨💻를 검사하면 <ZWJ>(U+200D)로 결합된 3개의 스칼라 코드 포인트로 구성되어 있으며, JavaScript에서는 5개의 UTF-16 코드 단위, UTF-8에서는 11바이트를 차지한다는 사실을 알 수 있습니다.
Grapheme clusters (UAX #29): 1 -> [ "👨💻" ]
Unicode scalar code points: 3 -> U+1F468 (Man) + U+200D (<ZWJ>) + U+1F4BB (Laptop)
UTF-16 code units (.length): 5 -> D83D DC68 + 200D + D83D DCBB
UTF-8 encoded bytes: 11 -> F0 9F 91 A8 + E2 80 8D + F0 9F 92 BB