이 글에서 소개한 도구
글을 읽으면서 브라우저에서 바로 도구를 열어 작업 흐름을 직접 확인해 보세요.
URL에 %20이나 %2F 같은 문자열이 있는 이유
URL은 특정 문자만 안전하게 사용할 수 있습니다. 공백, 비영어 텍스트, 값 안의 슬래시, 기호, 예약 문자는 URL에 넣기 전에 퍼센트 인코딩이 필요한 경우가 많습니다.

DevToolKits의 **URL 인코더·디코더**는 읽을 수 있는 텍스트를 URL에 안전한 문자열로 변환하고, 기존 값을 다시 텍스트로 디코딩해 줍니다.
예시: 검색 키워드를 URL에 넣기
검색 키워드 Tokyo Station cafe를 URL에 넣고 싶다고 합시다. 공백은 환경에 따라 표시나 복사 시 깨질 수 있습니다.
Tokyo Station cafe
URL 인코딩하면 다음과 같이 됩니다.
Tokyo%20Station%20cafe
쿼리 파라미터에 넣으면 공유하기 좋은 URL이 됩니다.
https://example.com/search?q=Tokyo%20Station%20cafe
원래 문자열로 디코딩되는지 확인해 두면 검색 조건이 잘못되거나 문자가 깨지는 것을 발견하기 쉽습니다.
인코딩이 중요한 경우
검색 URL, 콜백 URL, API 쿼리 파라미터, 리다이렉트 대상, 추적 링크를 만들 때 인코딩이 특히 중요합니다. 값이 올바르게 인코딩되지 않으면 브라우저나 서버가 엉뚱한 문자에서 분리해 다른 파라미터로 해석할 수 있습니다.
예를 들어 공백은 문맥에 따라 %20이나 +로 나타날 수 있습니다. 쿼리 값 안의 슬래시는 경로의 슬래시와 다르게 처리해야 할 수 있습니다.
예시: 콜백 URL을 이중으로 처리하지 않기
OAuth나 외부 연동에서는 URL 안에 다른 URL을 값으로 넣는 경우가 있습니다.
https://app.example.com/callback?next=/dashboard?tab=billing
이런 값을 redirect_uri에 넣을 때는 값으로 넘기는 URL 부분을 인코딩합니다.
redirect_uri=https%3A%2F%2Fapp.example.com%2Fcallback%3Fnext%3D%2Fdashboard%3Ftab%3Dbilling
여기서 주의할 것은 이미 인코딩된 값을 한 번 더 인코딩해 버리는 경우입니다. %가 %25로 바뀌어 있다면 이중 인코딩일 가능성이 있습니다. 디코딩 결과를 확인해 기대한 URL로 돌아오는지 보면 원인을 가려내기 쉽습니다.
쿼리 문자열은 따로 확인하기
URL에 파라미터가 많을 때는 **URL 파라미터 JSON 변환 도구**로 쿼리 문자열을 키와 값으로 분해하세요. 공유하거나 배포하기 전에 추적 링크와 API 요청을 훨씬 검토하기 쉬워집니다.
이 도구의 변환 규칙: URL 전체가 아니라 ‘값’을 변환한다
이 도구의 동작은 JavaScript의 encodeURIComponent / decodeURIComponent와 같습니다. 실제 변환 결과는 다음과 같습니다.
| 입력 | 인코딩 결과 | 포인트 |
|---|---|---|
a b+c |
a%20b%2Bc |
공백은 +가 아니라 %20. + 자체는 %2B가 된다 |
a/b:c@d |
a%2Fb%3Ac%40d |
/ : @도 인코딩된다 |
https://example.com/a b?x=1&y=2#top |
https%3A%2F%2Fexample.com%2Fa%20b%3Fx%3D1%26y%3D2%23top |
URL 전체를 넣으면 구분자인 : / ? & = #까지 변환되어 링크로 쓸 수 없게 된다 |
it's (ok)! *~-_. |
it's%20(ok)!%20*~-_. |
영숫자와 ! ' ( ) * ~ - _ .은 변환되지 않는다 |
😀 |
%F0%9F%98%80 |
UTF-8의 4바이트가 %XX 4개가 된다 |
100% |
100%25 |
% 자체도 %25가 된다 |
따라서 쓰임새는 ‘쿼리 값’, ‘경로의 한 구간’, ‘redirect_uri의 값’처럼 URL의 부품입니다. URL 전체가 아니라 값만 넣어 변환하고, ?q= 뒤에는 직접 이어 붙입니다. ‘변환 범위’에서는 값만(encodeURIComponent) 외에 URL 전체(encodeURI. : / ? & = #는 남기고 공백과 비ASCII 문자만 변환)와 폼 형식(공백을 +로 하고, 디코딩에서는 +를 공백으로 되돌림)도 고를 수 있습니다.
디코딩 동작도 알아 두면 오류의 원인을 가려내기 쉽습니다.
+는 공백으로 돌아오지 않습니다(a+b는a+b그대로). 폼 형식의+를 공백으로 읽고 싶다면 먼저+를%20으로 바꾼 뒤 디코딩합니다%E6%9D처럼 중간에 끊긴 UTF-8이나100%처럼%뒤가 16진수가 아닌 것은URI malformed오류가 납니다. 복사할 때 끝부분이 빠지지 않았는지 확인하세요%u3042같은 구식 표기는 디코딩할 수 없어 오류가 납니다
요약
URL 인코딩은 작은 디테일이지만 링크 깨짐, 잘못된 API 요청, 추적 오류를 막아줍니다. 받는 것은 디코딩하고, 보내는 것은 인코딩하며, 긴 쿼리 문자열은 가능한 한 구조화된 데이터로 검토하세요.
자주 묻는 질문
%20과 +는 둘 다 공백인가요?
둘 다 공백을 나타내지만 문맥이 다릅니다. URL 경로와 퍼센트 인코딩에서는 공백이 %20입니다. 쿼리 문자열(application/x-www-form-urlencoded)에서는 공백이 +로 표현될 수 있습니다. API나 폼이 기대하는 형식을 확인하고, URL 인코더·디코더로 실제로 보내는 문자열을 검증하세요.
이중 인코딩은 어떻게 알아보나요?
%는 값의 일부일 때 보통 %25로 인코딩됩니다. 디코딩 결과에 %25가 있거나, 한 번 디코딩해도 원래 URL로 돌아오지 않으면 이미 인코딩된 값을 다시 인코딩한 “이중 인코딩”일 가능성이 높습니다. 한 번 디코딩해 기대한 URL로 돌아오는지 확인하면 원인을 분리하기 쉽습니다.
URL의 비영어 문자는 항상 인코딩해야 하나요?
주소창에는 그대로 보일 수도 있지만, 링크로 공유하거나 API에 전달할 때는 환경에 따른 깨짐을 막기 위해 인코딩하세요. 예를 들어 東京은 UTF-8 바이트열인 %E6%9D%B1%E4%BA%AC로 인코딩됩니다.
