Go와 HTMX로 서버 사이드 렌더링과 동적 인터랙션을 결합하는 법

글에서는 Go의 `html/template` 패키지를 활용하여 서버 사이드 렌더링(Server-Side Rendering)을 유지하면서 HTMX를 통해 동적인 상호작용을 구현하는 패턴을 상세히 설명합니다. `base.tmpl`, `pages/*.tmpl`, `partials/*.tmpl` 구조를 통해 HTML 마크업의 재사용성(Reusability)을 극대화하고, `render()` 함수에서 전체 페이지 또는 부분 템플릿을 유연하게 반환하는 방식이 핵심입니다. 이는 점진적 향상(Progressive Enhancement)을 지원하며 개발 생산성을 높이는 데 기여합니다.

Go 1.16부터 도입된 파일 임베딩(File Embedding) 기능을 활용하여 HTML 템플릿과 정적 파일(CSS, JS)을 Go 바이너리에 직접 포함시키는 방식을 소개합니다. `assets/efs.go` 파일에서 `embed.FS`를 사용하여 런타임 시 디스크에서 파일을 읽는 대신, 단일 바이너리 배포(Single Binary Deployment)를 가능하게 합니다. 이는 배포 복잡성을 줄이고 애플리케이션의 이식성을 높이는 중요한 장점입니다.

HTMX 요청(`HX-Request: true` 헤더)과 일반 브라우저 요청을 구분하여 동적인 응답 전략을 구현하는 방법을 다룹니다. `isHTMXRequest()` 함수를 통해 HTMX 요청 시에는 부분 HTML(HTML Partial)을 반환하고, 일반 요청 시에는 전체 HTML 페이지를 반환하도록 처리합니다. 또한, `Vary: HX-Request` 헤더를 설정하여 캐싱 문제를 방지하고, `hx-push-url` 사용 시 브라우저 히스토리 관리를 위한 `historyRestoreAsHxRequest: false` 설정을 강조합니다.

일반적인 HTTP 리다이렉트(3xx)와 달리, HTMX 환경에서는 `HX-Redirect` 또는 `HX-Location` 헤더를 사용한 2xx 응답 기반의 리다이렉트 방식을 설명합니다. 이는 HTMX가 리다이렉트 과정을 가로채지 못하는 문제를 해결합니다. 또한, HTMX의 `responseHandling` 설정을 통해 다양한 HTTP 오류 코드(4xx, 5xx)에 대한 클라이언트 측 처리 방식을 커스터마이징하여 사용자에게 명확한 피드백을 제공하는 방법을 제시합니다.