손상된 Base64를 여기에 붙여넣고 "Base64 수정하기!!"를 클릭하여 복원하세요유효하지 않은 Base64 입력

Base64 수정 도구란?

복사한 Base64가 디코딩되지 않아 곤란했던 적 있으신가요? `=` 패딩이 부족하거나, 메일·채팅 클라이언트에서 줄바꿈이 끼어들었거나, URL-safe 변형과 표준 변형이 섞이는 경우가 흔합니다. 이 도구는 이 모든 것을 자동으로 정리합니다. 손상된 문자열을 붙여넣고 버튼을 누르면 디코딩 가능한 형태로 돌아옵니다.

Base64는 RFC 4648에서 정의된 엄격한 인코딩으로, 4문자 단위 그룹과 선택적 `=` 패딩, 두 가지 문자 집합(표준 `+/`과 URL-safe `-_`)을 사용합니다. MDN의 Base64 문서에 자세히 설명되어 있듯이, 브라우저의 btoa / atob는 규칙에서 조금만 벗어나도 예외를 던집니다. Wikipedia의 Base64 항목은 각 변형이 어디에 쓰이는지(메일 MIME, JWT, data URL, S3 키 등) 잘 정리해 줍니다. 실제 문자열은 이런 환경 사이를 오가며 깨지기 마련입니다.

모든 처리는 브라우저 내에서 실행됩니다. 데이터는 사용자 컴퓨터에 머무릅니다. 문자열을 수정한 뒤 코드나 curl 호출에 다시 붙여넣고 작업을 계속하세요.

Base64 수정 도구 사용법

세 단계입니다. 각 단계는 이 페이지의 실제 버튼과 패널을 사용합니다.

손상된 Base64 붙여넣기 또는 샘플 불러오기

손상된 Base64를 왼쪽 편집기에 붙여넣으세요. 샘플 Base64를 클릭하면 도구가 처리하는 입력의 예시를 볼 수 있습니다. 흔한 패턴 — 메일 줄바꿈으로 인한 개행, 부족하거나 남는 `=` 패딩, `+`·`/`에 섞인 `-`·`_`, 끝에 붙은 잡문자:

SGVsbG8gV29ybGQ
U0tVLTEwMQ==-_invalid

도구는 이 모든 것을 RFC 4648에 따라 정규화합니다. 공백을 제거하고, 길이가 4의 배수가 되도록 패딩을 조정하며, 필요하면 표준과 URL-safe 알파벳 사이를 전환해 결과가 디코딩되도록 합니다.

"Base64 수정하기!!" 클릭

녹색 Base64 수정하기!! 버튼을 누르세요. 문자열이 백엔드로 전송되어 분석된 뒤 깔끔하게 다시 출력됩니다. 처리되는 동안 로딩 표시기가 나타나며, 보통 1~2초면 끝납니다.

결과 확인

오른쪽 패널에 복원된 Base64가 표시됩니다. 디코딩된 바이트는 원래 표현하려던 것과 동일합니다 — 인코딩만 수정됩니다. 출력을 복사해 디코더, API 호출, data URL 어디든 필요한 곳에 붙여넣으세요.

이 도구를 활용하는 상황

API·JWT 디버깅

API에서 받은 Base64 페이로드나 JWT 세그먼트가 로컬에서는 디코딩되지 않을 때, 붙여넣고 즉시 정리할 수 있습니다. 클라이언트가 임의로 URL 인코딩해 깨진 경우도 복구됩니다.

채팅·메일에서 복사한 문자열 복구

Slack, Teams, 메일은 긴 Base64 블록에 줄바꿈을 넣는 것을 좋아합니다. 가끔 복사 시 `+`가 공백으로 바뀌기도 합니다. 도구가 두 가지 모두 되돌립니다.

표준 vs URL-safe 변형

JWT는 URL-safe Base64를, 대부분의 API와 S3는 표준 Base64를 씁니다. 이 두 환경 사이를 오가다 보면 인코딩이 어긋나기 쉬운데, 여기서 패딩을 맞추고 `-`·`_`를 `+`·`/`로 바꾸면 다시 디코딩됩니다.

Data URL 페이로드

CSS나 HTML의 data: URL이 더 이상 렌더링되지 않을 때, 보통 Base64 페이로드가 원인입니다. `data:image/png;base64,...` 전체를 붙여넣으면 — 접두부는 그대로 두고 인코딩 부분만 수정합니다.

자주 묻는 질문

Base64 데이터가 저장되나요?

아니요. 모든 처리는 JavaScript를 사용해 브라우저 내에서 이루어집니다. 문자열은 우리가 읽을 수 있는 형태로 컴퓨터를 떠나지 않습니다 — 기록하지 않으며, 보지도 않습니다.

어떤 종류의 오류를 수정하나요?

`=` 패딩 부족·과잉, 줄바꿈과 공백 혼입, URL-safe(`-_`)와 표준(`+/`) 문자 혼용, 끝부분의 잡문자, 4의 배수가 아닌 길이를 수정합니다. 기반 바이트가 부분적으로 손상된 경우(누군가 문자 중간에서 잘라낸 경우 등)는 복구에 한계가 있습니다.

디코딩된 데이터는 동일하게 유지되나요?

네. RFC 4648에 맞게 인코딩만 정규화합니다. atob에서 나오기로 되어 있던 바이트가 그대로 나옵니다. 내용 자체는 건드리지 않습니다.

URL-safe Base64도 처리하나요?

네. 표준 알파벳(`+/`)과 URL-safe 변형(`-_`) 모두 지원합니다. 입력이 두 가지를 섞고 있으면, 문자열에서 우세해 보이는 쪽을 선택해 그쪽으로 정규화합니다.

이미지나 PDF의 Base64도 됩니까?

됩니다. 내용물은 인코딩 수정에 영향을 주지 않습니다. `data:image/png;base64,...` URL을 붙여넣으면 접두부는 보존되고 인코딩된 페이로드만 복구됩니다.

수정된 Base64는 항상 디코딩되나요?

형식 단계의 손상은 복구됩니다. 원본 바이트 자체가 부분적으로 손상되었다면(비트가 사라지거나 다시 쓰였다면) 어떤 인코딩 보정도 그것을 되살릴 수 없습니다 — 디코딩은 되지만 손상 지점에서 잡음이 보일 수 있습니다. 이후 Base64 디코더로 검증하세요.

Base64 수정 도구