260806_03_ENH: mutipart 한글 꺠짐 개선

This commit is contained in:
2026-08-06 13:57:18 +09:00
parent e8888794c3
commit f08ecf4da0
4 changed files with 23 additions and 108 deletions

View File

@@ -186,15 +186,12 @@ ExternalApiResponse res = client.postMultipart(url, headers, parts);
multipart 요청에서는 전달한 headers의 `Content-Type` 값을 무시하고, 필요한 boundary를 포함한
`Content-Type: multipart/form-data; boundary=...` 값을 자동 생성합니다.
boundary와 multipart 파트 헤더는 US-ASCII로 생성하고, 텍스트 필드 내용은
UTF-8, 파일 내용은 원본 `byte[]`로 전송합니다. ASCII 파일명은 기존 `filename`을
그대로 사용합니다. non-ASCII 파일명은 서버 호환성을 위해 충돌하지 않는 ASCII
fallback을 `filename`에 넣고, UTF-8 퍼센트 인코딩한 원본 파일명을 `filename*`에
함께 전송합니다. 공백은 `+`가 아닌 `%20`으로 인코딩됩니다.
multipart 파트 헤더와 텍스트 필드는 UTF-8로 인코딩하고, 파일 내용은 원본
`byte[]`로 전송합니다. ASCII와 non-ASCII 파일명 모두 원본 값을 quoted `filename`에
UTF-8 바이트로 전송하며, ASCII fallback이나 `filename*`는 추가하지 않습니다.
```http
Content-Disposition: form-data; name="file"; filename="attachment.txt";
filename*=UTF-8''%ED%95%9C%EA%B8%80-%ED%8C%8C%EC%9D%BC.txt
Content-Disposition: form-data; name="file"; filename="한글-파일.txt"
```
지원 메서드:
@@ -773,5 +770,8 @@ Endpoint:
## 변경 이력
- 2026-08-06: non-ASCII multipart 파일명을 ASCII `filename` fallback과 UTF-8 `filename*`로 함께 전송하도록 개선했습니다.
- 2026-08-06: `beta.1.6.3`에서 non-ASCII multipart 파일명을 ASCII fallback/
`filename*` 없이 원본 `filename`의 UTF-8 바이트로 전송하도록 복원했습니다.
- 2026-08-06: `beta.1.6.2`에서 non-ASCII multipart 파일명에 ASCII `filename`
fallback과 UTF-8 `filename*`를 추가했습니다.
- 2026-08-04: `kri.auth.apikey.allowed-paths`와 `kri.auth.apikey.excluded-paths`를 추가했습니다. 미설정·`null`·빈 목록은 기존 전역 API Key 인증 동작을 유지하며, 제외 패턴은 허용 패턴보다 우선합니다.