fix: swagger-config 프록시 누락으로 Swagger UI가 petstore로 폴백되는 문제 수정

[sjungwon03]

변경 내용

• nginx.conf의 location = /v3/api-docs(정확히 일치)를 location /v3/api-docs(prefix)로 변경

배경

#245 배포 후 실제로 확인해보니 Swagger UI가 https://petstore.swagger.io/v2/swagger.json 데모 스펙으로 떴다. 원인은 swagger-ui JS가 페이지 로드시 실제 스펙 위치를 알아내려고 GET /v3/api-docs/swagger-config를 추가로 호출하는데, 기존 nginx location이 /v3/api-docs를 정확히 일치로만 매칭해서 이 하위 경로 요청이 SPA fallback(index.html)으로 떨어졌기 때문이다. swagger-ui는 이 요청이 JSON이 아니면 조용히 기본 데모 설정으로 폴백한다.

검증

• nginx -t 문법 검증 통과
• docker compose up -d --build backend frontend 후 frontend 컨테이너 내부(127.0.0.1:80)에서 직접 확인
  • GET /v3/api-docs → 200
  • GET /v3/api-docs/swagger-config → 200, 응답 본문 "url":"/v3/api-docs" 확인 (이전에는 SPA index.html이 떨어졌음)
  • GET /swagger-ui/index.html → 200
  • GET / → 200, SPA 라우팅 정상 유지

연결 이슈

Closes #246

[kilo-code-bot]

Code Review Summary

Status: No Issues Found | Recommendation: Merge

Files Reviewed (1 file)

• nginx.conf

---

_{Reviewed by step-3.7-flash · Input: 42K · Output: 6.9K · Cached: 267.3K}