본문 바로가기

주소에 공백과 +가 들어갈 때: URL 인코딩 오류 구분

파일·브라우저 실험작성 SW픽 편집부 · 발행
프로그램
웹 브라우저
환경
독립 HTML · 1280px 브라우저 실험
버전
JavaScript URLSearchParams
실험·자료 확인일

q=A+B: A B / q=AB: A B / q=AB: A+B

주소에 공백과 +가 들어갈 때: URL 인코딩 오류 구분의 핵심 문제와 공개 예제 결과를 정리한 표지

주소를 복사했는데 공백이 +로 바뀌거나 실제 + 문자가 공백으로 읽힐 수 있습니다. 특히 쿼리 매개변수에서는 +·%20·%2B를 같은 문자로 취급하면 파일명이나 검색어가 달라집니다. 주소 전체를 여러 번 인코딩하기보다 값이 어느 단계에서 어떻게 해석되는지 먼저 확인해야 합니다.

먼저 구분할 조건

URL의 경로와 쿼리 값은 각각의 처리 규칙을 봐야 합니다. URLSearchParams처럼 폼 형식의 쿼리를 읽는 도구는 +를 공백으로 해석할 수 있습니다. 실제 + 문자를 전달하려면 그 값을 맞는 방식으로 인코딩해야 합니다. 이미 인코딩된 값에 다시 인코딩을 적용하면 % 자체가 %25로 바뀌어 한 번 해석한 결과에 인코딩 문자열이 남을 수 있습니다.

주소에 공백과 +가 들어갈 때: URL 인코딩 오류 구분의 공개 예제 관찰 결과와 확인 항목
공개 예제의 확인 항목을 정리한 설명용 도식입니다. 실제 제품 앱 화면은 아닙니다.

직접 확인한 예제와 방법

독립 HTML에서 브라우저의 URLSearchParams로 q=A+B, q=A%20B, q=A%2BB, q=A%2520B를 직접 읽었습니다. 순서대로 A B, A B, A+B, A%20B가 표시됐습니다. 마지막 값은 한 번 해석한 뒤에도 %20이라는 문자 표현이 남았습니다. 가상 쿼리 문자열을 브라우저에서 파싱한 시험이며 실제 서버의 파일 권한이나 다운로드 성공을 확인한 실험은 아닙니다.

이 글의 공개 자료에서 확인한 결과
확인 항목 관찰 결과
q=A+B A B
q=A%20B A B
q=A%2BB A+B
q=A%2520B A%20B

결과를 해석하는 기준

+와 공백이 달라져야 하는 파일명이라면 잘못된 해석이 검색 실패나 다른 값의 선택으로 이어질 수 있습니다. 하지만 모든 URL의 +가 무조건 공백이라는 뜻은 아닙니다. 사용한 쿼리 파서와 위치의 규칙을 명시해야 합니다. 경로·fragment·쿼리를 하나의 임의 치환 함수로 처리하지 않는 것이 좋습니다.

encodeURIComponent는 값의 인코딩에 사용할 수 있지만 URL 전체를 그대로 넣으면 구분자인 &·=까지 값처럼 바뀔 수 있습니다. 이미 처리된 값과 원문 값을 구분해 한 단계씩 비교하세요. 눈에 보이는 주소가 복잡하다는 이유로 반복 디코딩하면 원래 의도한 값과 구분자의 의미가 바뀔 수 있습니다.

같은 +가 값과 구분 규칙에서 다르게 쓰입니다

작성 예제로 이름 A+B의 자료를 쿼리로 찾는 상황을 생각해 볼 수 있습니다. A+B를 그대로 폼형식 쿼리에 넣으면 읽은 값이 A B가 될 수 있습니다. 원문 값을 한 번 인코딩해 A%2BB로 전달하는 단계와 주소 구조를 조립하는 단계를 나눠야 합니다.

상황 확인할 질문 먼저 할 일
실제 + 문자가 필요한 값 쿼리 파서가 +를 어떻게 읽나 원문과 최종 값을 대조
%20이 문자로 남음 이미 인코딩한 값을 또 처리했나 처리 단계와 원문을 구분
주소 전체를 값처럼 인코딩 &·= 등의 구분자가 유지됐나 값과 URL 구조를 따로 조립

개인 토큰이 없는 가상 값으로 동일한 문제를 재현하면 안전하게 오류 범위를 설명할 수 있습니다. 응답 성공과 올바른 값 선택은 각각 확인해야 합니다.

내 자료에서 확인할 순서

  1. 원문 파일명·검색어·주소와 실제 전달된 주소를 각각 보존합니다. 오류가 난 URL을 먼저 임의로 정리하지 않습니다.
  2. 문제가 경로·쿼리 값·fragment 중 어디에 있는지 확인합니다. 각 위치의 구분 기호와 처리 규칙을 나눕니다.
  3. 비민감한 작은 예제로 공백·실제 +·% 문자를 각각 전달해 읽은 결과를 비교합니다. 서버와 클라이언트가 어떤 파서를 쓰는지도 확인합니다.
  4. 원문 값만 필요한 규칙으로 인코딩하고 주소 구조의 구분자를 보존합니다. 이미 인코딩된 문자열인지 단계별로 기록합니다.
  5. 최종으로 읽힌 값이 원문과 같은지 비교합니다. 요청이 성공한 것만으로 올바른 파일이나 검색어가 선택됐다고 판단하지 않습니다.
  6. 오류 기록을 공유할 때는 개인 토큰·인증 정보·비공개 주소를 제외하고 가상 값과 처리 단계로 문제를 설명합니다.

잘못 바꾸었거나 확인이 어려울 때

주소에 인증 토큰이나 민감한 값이 포함돼 있으면 전체를 공개 예제에 붙여 넣지 않습니다. 권한이 없는 자료의 주소를 추측해서 고치는 안내도 아닙니다. 올바른 값이 전달되는데 서버가 접근을 거부하면 인코딩과 권한 문제를 분리해 제공자에게 확인해야 합니다.

정상 완료 기준

정상 완료는 원문 값과 최종 파싱 값이 같고, 한 번씩 적용한 인코딩·디코딩 단계가 분명하며, 의도한 공개 자료가 선택되는 상태입니다. 공개 실험에서는 네 쿼리가 표의 서로 다른 결과를 내야 합니다. 요청 주소의 문자열 동일성과 선택한 자료의 의미를 함께 확인하십시오.

같은 예제를 다시 확인할 자료

브라우저 URLSearchParams의 네 쿼리를 확인했습니다. 모든 서버·프레임워크의 반복 디코딩·경로 라우팅을 시험한 것은 아닙니다. 실제 시스템의 파서와 전달 규칙을 따로 확인해야 합니다.

자료는 비민감 가상 예제입니다. 손상·불일치라고 표시한 파일은 차이를 확인하는 실험용이며 업무 원본으로 사용하지 않습니다. 파일 크기·SHA-256 목록으로 내려받은 원본을 확인할 수 있습니다.

서버에서 주소 자체가 404인 경우는 WordPress 고유주소 복구와 다른 단계로 나눠 확인할 수 있습니다.

OFFICIAL SOURCES

확인한 공식 자료

CORRECTION

화면이 달라졌나요?

운영체제와 프로그램 버전, 달라진 단계를 알려주시면 다시 확인합니다.

정정 요청 보내기