Java/Spring URI 처리: RFC 표준 차이와 실무 함정

// Java
String encoded = URLEncoder.encode("hello world", StandardCharsets.UTF_8);
System.out.println(encoded); // 출력: hello+world

// JavaScript
const encoded = encodeURIComponent("hello world");
console.log(encoded); // 출력: hello%20world

// Backend - 캐시 키 생성
String cacheKey = "search:" + URLEncoder.encode("안녕 하세요", UTF_8);
// 결과: search:안녕+하세요

// Frontend - 캐시 조회 요청
const cacheKey = "search:" + encodeURIComponent("안녕 하세요");
// 결과: search:안녕%20하세요

URI uri = new URI("myapp://user_profile?version=1.0");
System.out.println(uri.getHost()); // 출력: null ```

`user_profile`이 host인데 왜 `null`이 반환될까요?

### 원인: RFC 2396의 hostname 규칙

`java.net.URI`는 [RFC 2396 Section 3.2.2](https://www.rfc-editor.org/rfc/rfc2396#section-3.2.2)를 따릅니다. 이 규칙에 따르면 hostname은:

> a sequence of domain labels separated by ".", each domain label starting and ending with an **alphanumeric character** and possibly also containing **"-"** characters.

즉, hostname에는 언더스코어(`_`)가 허용되지 않습니다.

```java
// 정상: 언더스코어 없음
new URI("myapp://userprofile?version=1.0").getHost();   // "userprofile"

// 문제: 언더스코어 포함
new URI("myapp://user_profile?version=1.0").getHost();  // null

URI uri = new URI("myapp://user_profile?version=1.0");
uri.getHost();       // null
uri.getAuthority();  // "user_profile" uri.toString();      // "myapp://user_profile?version=1.0" ```

`user_profile` 정보 자체가 사라진 것은 아닙니다. `authority`에 들어가 있습니다. 문제는 이 값을 다른 클래스와 함께 사용할 때 생깁니다.

---

## 함정 3: UriComponentsBuilder.fromUri()의 정보 누락

### 문제 상황

`java.net.URI`와 `UriComponentsBuilder`를 함께 사용할 때 발생하는 문제입니다:

```kotlin
// URL에서 특정 파라미터를 제거하는 확장함수
private fun String.removeDebugParameter(): String = 
    UriComponentsBuilder.fromUri(URI(this))  // 여기가 문제!
        .replaceQueryParam("debug", null)
        .build()
        .toUriString()

// 테스트
"myapp://home?debug=true&version=1.0".removeDebugParameter()
// 기대: myapp://home?version=1.0
// 실제: myapp://home?version=1.0 "myapp://user_profile?debug=true&version=1.0".removeDebugParameter()
// 기대: myapp://user_profile?version=1.0
// 실제: myapp://?version=1.0 (host가 사라짐!)

// UriComponentsBuilder.uri() 메서드 내부
public UriComponentsBuilder uri(URI uri) {
    this.host = uri.getHost();  // null이 반환됨!
    // uri.getAuthority()는 참조하지 않음
    ...
}

public class URIEncoder {
    
    /**
     * JavaScript의 encodeURIComponent와 동일하게 동작하는 인코딩.
     */
    public static String encodeURIComponent(String value) {
        if (value == null) return null;
        
        return URLEncoder.encode(value, StandardCharsets.UTF_8)
                .replace("+", "%20")   // 공백
                .replace("%7E", "~")   // 틸드
                .replace("%21", "!")   // 느낌표
                .replace("%27", "'")   // 작은따옴표
                .replace("%28", "(")   // 여는 괄호
                .replace("%29", ")");  // 닫는 괄호
    }
}

// 위험: java.net.URI를 경유하면 정보 누락 가능
UriComponentsBuilder.fromUri(new URI(urlString))  

// 권장: 문자열을 직접 파싱 (RFC 3986 정규식 사용)
UriComponentsBuilder.fromUriString(urlString)

// 쿼리 파라미터 추가
String url = UriComponentsBuilder.fromUriString("https://api.example.com/search")
        .queryParam("q", "hello world")        // 자동으로 %20 인코딩
        .queryParam("name", "홍길동")           // 한글 자동 인코딩
        .build()
        .toUriString();
// 결과: https://api.example.com/search?q=hello%20world&name=%ED%99%8D%EA%B8%B8%EB%8F%99

URI uri = new URI("myapp://user_profile?version=1.0");

// 방어적 코딩
String host = uri.getHost();
if (host == null) {
    host = uri.getAuthority();  // fallback
}

// 방법 1: 수동 치환
function encodeFormData(value) {
    return encodeURIComponent(value).replace(/%20/g, '+');
}

// 방법 2: URLSearchParams 사용
const params = new URLSearchParams();
params.append('message', 'hello world');
console.log(params.toString()); // message=hello+world

// 잘못된 예: 이미 인코딩된 문자열을 다시 인코딩
String alreadyEncoded = "hello%20world";
URLEncoder.encode(alreadyEncoded, UTF_8); // "hello%2520world" (% → %25)

// 딥링크 생성 예시
String innerUrl = "https://site.com/search?q=" + URIEncoder.encodeURIComponent("hello world");
// 결과: "https://site.com/search?q=hello%20world"

String deepLink = "myapp://webview?link=" + URIEncoder.encodeURIComponent(innerUrl);
// 결과: "myapp://webview?link=https%3A%2F%2Fsite.com%2Fsearch%3Fq%3Dhello%2520world"
//                                                               ↑ %20 → %2520

// Java URLDecoder: '+'를 공백으로 해석
URLDecoder.decode("hello+world", UTF_8);   // "hello world" URLDecoder.decode("hello%20world", UTF_8); // "hello world" ```

```javascript
// JavaScript decodeURIComponent: '+'를 그대로 유지
decodeURIComponent("hello+world");   // "hello+world" decodeURIComponent("hello%20world"); // "hello world" ```

> [!WARNING]
> JavaScript에서 Form 인코딩된 데이터(`+`가 공백인 경우)를 디코딩하려면:
> ```javascript
> function decodeFormData(value) {
>     return decodeURIComponent(value.replace(/\+/g, '%20'));
> }
> ```

---

## 요약

| 함정 | 원인 | 해결책 |
|:---|:---|:---|
| Java/JS 인코딩 불일치 | URLEncoder는 RFC 2396 + Form 스펙 | `URIEncoder.encodeURIComponent()` 유틸리티 |
| `URI.getHost()` null 반환 | RFC 2396은 hostname에 `_` 불허 | `getAuthority()` fallback 또는 회피 |
| `fromUri()` 정보 누락 | `UriComponentsBuilder`가 `authority` 미참조 | `fromUriString()` 사용 |

정리하면, Java의 URI 관련 클래스 중 일부는 1998년 표준(RFC 2396)의 영향을 아직 받습니다. 현대 웹 개발에서는 가능한 한 RFC 3986 기준으로 파싱하고 인코딩하는 도구를 쓰는 편이 안전합니다.

```java
// java.net.URI를 거치지 않는다
UriComponentsBuilder.fromUriString(url)
        .queryParam("key", "value")
        .build()
        .toUriString();