[Tomcat] 페이지 이동 후 400 에러, IllegalArgumentException

✔️ 트러블 슈팅

---

▶︎ 발단

프로젝트 체크아웃 후 로컬 환경 테스트 중 페이지로 리다이렉션 과정에서 (HTTP) 400 Bad Request가 발생했다. 에러 로그는 다음과 같다.

정보: Error parsing HTTP request header
Note: further occurrences of HTTP header parsing errors will be logged at DEBUG level.java.lang.IllegalArgumentException: Invalid character found in the request target. The valid characters are defined in RFC 7230 and RFC 3986 ...

---

▶︎ 원인

Tomcat의 특정 버전에서 특수문자를 파라미터로 허용하지 않는다. 리다이렉션 URL의 쿼리스트링에 포함된 특수문자를 톰캣이 처리하지 못해 발생한 문제이다. 해당 프로젝트의 경우 쿼리스트링에 버티컬 바(|)를 이용해 파라미터를 구분하도록 하여 문제가 발생했다.

---

▶︎ 해결

특수문자를 허용하는 Tomcat 버전을 사용하거나, server.xml 에 relaxedQueryChars 옵션을 통해 허용할 문자열을 명시한다.

<Connector
    connectionTimeout="20000"
    port="8080"
    protocol="HTTP/1.1"
    redirectPort="8443"
    relaxedQueryChars="|" />