Decodex

DECODEX · BASE64

Base64 디코딩 오류 해결 방법

Base64 문자 형식, 문자 해석, 파일 복원 중 어느 단계에서 실패했는지 진단합니다. 이 글은 문제를 분류하는 출발점이며, 각 원리는 별도 가이드에서 다룹니다.

정상 값으로 변환 단계부터 구분하기

텍스트 디코더에 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
오류 (의도한 거부)실행 전
A
Base64 → UTF-8
오류 (의도한 거부)실행 전
/w==
Base64 → UTF-8
오류 (의도한 거부)실행 전
00 ff 01 80
Base64 → bytes
AP8BgA== → 00 ff 01 80실행 전
00 ff 01 80
SHA-256
edc81f7e4ee358fb91e94bd9bd74079c3dcba36f40f2c8a36e7ae0567afecc8f실행 전

결과 해석

FF는 올바른 바이너리 바이트지만 UTF-8 텍스트로는 유효하지 않습니다. 텍스트 변환 오류만으로 파일 손상을 판단하면 안 됩니다. 4바이트 파일 예제는 원본 바이트와 복원 바이트가 같고 변환 전후 SHA-256도 일치합니다.

재현 순서

검증표를 실행한 다음 텍스트 디코더에 SGVsbG8=를 넣어 Hello가 나오는지 먼저 확인하세요. AP8BgA==를 .txt 파일로 저장하고 파일 디코딩 영역에서 4바이트 파일로 복원하세요. 확장자만 바꾸고 성공했다고 판단하지 말고 바이트나 SHA-256을 비교하세요.

Base64 →

검증 방법

공개해도 되는 고정 예제를 변환 도구와 같은 파일 코덱·문자 코덱으로 실행합니다. JavaScript 사례는 브라우저 내장 btoa, TextEncoder, URLSearchParams, SHA-256도 확인합니다. 스크립트를 실행하기 전부터 기대 결과를 읽을 수 있고, 버튼을 누르면 현재 브라우저의 실제 결과와 비교합니다. 입력을 업로드하지 않습니다.

JavaScript · guide-cases.js · JavaScript · file-codec.js

검증 범위와 한계

2026-10-21 검토. 작은 고정 예제와 100,000자 입력 한 건의 정확성을 확인하며 속도 측정이나 모든 파일의 성공을 보장하는 검사는 아닙니다. 4바이트 파일은 PNG·PDF가 아닌 합성 바이너리입니다. SHA-256 일치는 바이트 보존을 확인할 뿐 파일 실행의 안전성을 증명하지 않습니다. 브라우저 지원에 따라 결과가 달라질 수 있습니다.

참고 자료

문제에 맞는 가이드 선택