검색어 C++가 공백으로 바뀐 이유: +·%2B·빈값 URL 인코딩 실험

C++를 그대로 붙였더니 C와 공백 두 개가 됐습니다

검색어를 URL 뒤에 붙이는 코드를 점검하려고 q=와 입력 문자열을 단순히 더한 경우를 만들었습니다. Python의 폼 방식 쿼리 파서에서 q=C++를 읽으면 값은 C 뒤에 공백 두 개가 붙은 문자열입니다. 이번 실험은 실제 검색 사이트의 장애를 재현한 것이 아니라, 문자열 생성과 파싱을 같은 프로세스에서 대조한 격리 실험입니다.

2026년 10월 23일 C++, A B, 서울&부산, a=b, 100%, 빈 문자열을 입력했습니다. 각 값에 대해 원시 연결 쿼리, 그 파싱 결과, urlencode 쿼리, 다시 읽은 결과를 보관했습니다. 여섯 입력 모두 올바르게 인코딩한 경로에서는 입력과 결과가 일치한다는 단언문을 실행했습니다.

공백의 +와 문자 그대로의 +를 나눕니다

폼 방식 쿼리에서 공백을 나타내는 +와 검색어의 더하기 기호는 다른 역할입니다. urlencode는 C++의 두 기호를 %2B%2B로 바꿉니다. 반대로 A B는 A+B로 만들어도 같은 파서로 읽으면 원래 공백으로 돌아옵니다. 핵심은 모든 +를 금지하는 것이 아니라 값의 문자와 쿼리 문법을 구분하는 것입니다.

이미 인코딩한 C%2B%2B를 다시 원본 값처럼 urlencode에 넣으면 쿼리는 q=C%252B%252B가 됩니다. 이를 한 번 파싱한 값은 C++가 아니라 C%2B%2B입니다. 원본 문자열에서 시작한 왕복 검사와 완성된 URL 조각을 다시 처리하는 경우를 구분해야 합니다. 인코딩을 여러 번 하면 더 안전해지는 것이 아니라 다른 값을 만들 수 있습니다.

서울&부산은 두 검색어가 아니라 한 값일 수 있습니다

직접 붙인 q=서울&부산에서 &는 값 안의 글자가 아니라 필드 구분자로 해석됩니다. 보관한 결과에는 q 값이 서울로 잘리고 부산이라는 빈 필드가 별도로 생깁니다. urlencode에 원본 문자열을 전달하면 &를 값의 일부로 보존할 수 있습니다. 사람이 읽는 검색 문장을 먼저 쪼개지 말고 데이터와 문법을 나누어 조합해야 하는 이유입니다.

a=b도 같이 넣었습니다. parse_qs는 이 예제에서 첫 = 뒤를 값으로 읽으므로 모든 기호 입력이 같은 방식으로 깨지는 것은 아닙니다. 문제가 없는 한 사례만 보고 수동 연결을 일반화하지 않고, +·&·=·%·한글을 각각 포함한 작은 회귀 입력을 유지하는 편이 낫습니다.

빈 문자열과 누락, 0은 서로 다른 상태입니다

parse_qs의 기본 설정은 q=의 빈값을 결과에서 제외합니다. keep_blank_values=True를 지정하면 q의 값 목록에 빈 문자열이 남습니다. q 자체가 없는 요청, q가 있지만 빈 요청, q=0인 요청은 필터와 검색 기능에서 다른 뜻을 가질 수 있으므로 서버가 어떤 계약을 쓸지 먼저 정해야 합니다.

같은 키가 반복되는 q=C%2B%2B&q=A+B도 읽었습니다. 결과는 값 두 개를 가진 목록입니다. 딕셔너리 하나에 마지막 값만 저장하는 다른 처리로 바꾸면 이 정보가 사라질 수 있습니다. 어느 값을 선택할지는 서비스 정책이며, 파서가 돌려준 목록을 확인하는 것과 최종 검색 조건을 결정하는 것은 별도 단계입니다.

쿼리 성공을 URL 경로 전체의 성공으로 확대하지 않습니다

여기서 확인한 것은 application/x-www-form-urlencoded 방식의 쿼리입니다. 파일 경로나 URL의 path 전체에 같은 + 규칙을 적용했다는 뜻이 아닙니다. 경로 조합, 프록시의 디코딩, 웹 프레임워크의 중복 키 처리와 브라우저 주소창은 이번 실행 범위에 포함하지 않았습니다.

실서비스에서는 브라우저가 보낸 URL, 서버가 받은 원시 쿼리, 애플리케이션이 파싱한 값 중 어느 단계에서 바뀌는지 좁혀 확인합니다. 운영 로그에 사용자의 검색어 전체를 남겨야 한다는 의미는 아닙니다. 먼저 이번처럼 개인정보 없는 고정 합성 입력으로 재현하고, 실제 서비스의 프레임워크 문서와 비교할 수 있습니다.

같은 입력이 돌아오는지 검증하는 작은 검사

재현 코드는 네트워크 없이 여섯 입력의 결과와 Python 버전을 JSON으로 저장합니다. 내려받은 이름이 lab-query-encoding.py.txt라면 마지막 .txt를 제거해 코드를 읽고, python3 lab-query-encoding.py --output my-query-results.json으로 실행할 수 있습니다. 이 출력 옵션은 같은 이름의 파일이 이미 있으면 중단합니다. 셸의 > 출력으로 기존 검산 파일을 덮어쓰지 않도록 실행 방법을 구분하세요.

원본 문자열을 문자열 조각으로 붙이지 않고 구조화된 매개변수로 넘기는 것을 기본 선택으로 삼겠습니다. 다만 빈값을 남길지, 중복 키를 허용할지까지 인코더가 대신 정해 주지는 않습니다. 이 두 가지 계약을 명시하고 원본과 되돌린 값의 일치 검사를 함께 두어야 같은 오류를 다시 찾기 쉽습니다.

python3 lab-query-encoding.py --output my-query-results.json

python3 lab-query-encoding.py --output new-observations.json