정상 값으로 변환 단계부터 구분하기
텍스트 디코더에 SGVsbG8=를 넣어 Hello가 나오는지 확인하세요. 정상 값과 실패한 값을 따로 비교합니다. Zg=는 Base64 형식 오류이고, /w==는 Base64 자체는 정상이지만 복원한 FF 바이트를 UTF-8로 읽을 수 없는 경우입니다. 두 오류를 같은 방식으로 고치면 원인을 놓치기 쉽습니다.
텍스트 디코딩과 파일 디코딩 선택하기
문자열이 목적이면 원본 문자 인코딩을 선택합니다. 이미지·PDF 등 원본 파일이 목적이면 Base64를 텍스트 파일로 저장해 파일 디코딩 영역에서 복원하세요. 텍스트 결과 창은 파일 미리보기가 아닙니다. 아래 합성 예제에는 00과 FF를 넣어, 바이너리를 잘못 텍스트로 처리할 때 생기는 바이트 손실을 확인합니다.
디코더에 넣기 전의 포장과 전송 확인하기
JSON에서는 따옴표를 제외한 값만 복사하세요. 텍스트 디코더에는 data URL의 쉼표 뒤 부분을 넣고, 파일 디코딩에는 Base64 data URL 전체도 넣을 수 있습니다. 퍼센트 이스케이프는 먼저 URL 디코딩을 해야 합니다. 잘린 본문은 패딩만 추가해 복구할 수 없습니다. 로컬에서는 되는데 전송 후 실패한다면 URL 전송 가이드를 확인하세요.
직접 검증하는 사례
| 입력 / 작업 | 기대 결과 | 브라우저 실행 결과 |
|---|---|---|
SGVsbG8= | Hello | 실행 전 |
Zg=Base64 → UTF-8 | 오류 (의도한 거부) | 실행 전 |
ABase64 → UTF-8 | 오류 (의도한 거부) | 실행 전 |
/w==Base64 → UTF-8 | 오류 (의도한 거부) | 실행 전 |
00 ff 01 80Base64 → bytes | AP8BgA== → 00 ff 01 80 | 실행 전 |
00 ff 01 80SHA-256 | edc81f7e4ee358fb91e94bd9bd74079c3dcba36f40f2c8a36e7ae0567afecc8f | 실행 전 |
결과 해석
FF는 올바른 바이너리 바이트지만 UTF-8 텍스트로는 유효하지 않습니다. 텍스트 변환 오류만으로 파일 손상을 판단하면 안 됩니다. 4바이트 파일 예제는 원본 바이트와 복원 바이트가 같고 변환 전후 SHA-256도 일치합니다.
재현 순서
검증표를 실행한 다음 텍스트 디코더에 SGVsbG8=를 넣어 Hello가 나오는지 먼저 확인하세요. AP8BgA==를 .txt 파일로 저장하고 파일 디코딩 영역에서 4바이트 파일로 복원하세요. 확장자만 바꾸고 성공했다고 판단하지 말고 바이트나 SHA-256을 비교하세요.
검증 방법
공개해도 되는 고정 예제를 변환 도구와 같은 파일 코덱·문자 코덱으로 실행합니다. JavaScript 사례는 브라우저 내장 btoa, TextEncoder, URLSearchParams, SHA-256도 확인합니다. 스크립트를 실행하기 전부터 기대 결과를 읽을 수 있고, 버튼을 누르면 현재 브라우저의 실제 결과와 비교합니다. 입력을 업로드하지 않습니다.
JavaScript · guide-cases.js · JavaScript · file-codec.js
검증 범위와 한계
2026-10-21 검토. 작은 고정 예제와 100,000자 입력 한 건의 정확성을 확인하며 속도 측정이나 모든 파일의 성공을 보장하는 검사는 아닙니다. 4바이트 파일은 PNG·PDF가 아닌 합성 바이너리입니다. SHA-256 일치는 바이트 보존을 확인할 뿐 파일 실행의 안전성을 증명하지 않습니다. 브라우저 지원에 따라 결과가 달라질 수 있습니다.
참고 자료
문제에 맞는 가이드 선택
한글·이모지 Base64 인코딩과 디코딩
같은 문장을 서로 다른 문자 인코딩으로 만든 바이트를 비교합니다. 사이트 언어나 화면에 보이는 글자가 아니라 원본 시스템의 설정을 근거로 인코딩을 고르는 방법을 다룹니다.
Base64와 Base64URL 차이 — URL 안전 문자·패딩·디코딩 예제
Base64 값을 쿼리 문자열에 넣고 다시 꺼내는 과정을 따라갑니다. 원문 자체의 오류와 URL 전송 과정에서 생긴 손상을 분리합니다.
Base64 끝의 =와 == 의미 — 패딩 오류·생략 규칙 설명
바이트 묶음으로 패딩 수를 계산하고 잘못된 끝부분을 판별합니다. 문자 인코딩과 URL 전송은 다른 가이드에서 다룹니다.
JavaScript 한글 Base64 인코딩·디코딩 — btoa 오류 해결
JavaScript에서 유니코드를 변환하고, btoa()가 성공했는데도 UTF-8과 다른 바이트가 만들어지는 경우를 확인합니다.