Skip to content

[FIX] Swagger 문서 배포 환경 경로 문제 해결 및 Caddy 도메인 설정 업데이트#371

Merged
Arin0303 merged 3 commits intodevelopfrom
fix/#370
Jan 1, 2026
Merged

[FIX] Swagger 문서 배포 환경 경로 문제 해결 및 Caddy 도메인 설정 업데이트#371
Arin0303 merged 3 commits intodevelopfrom
fix/#370

Conversation

@Arin0303
Copy link
Copy Markdown
Collaborator

@Arin0303 Arin0303 commented Jan 1, 2026

📌 기능 설명

배포 서버(Docker) 환경에서 Swagger UI가 빈 화면으로 뜨는 문제를 해결하고, 실제 운영 도메인 접속을 위한 Caddy설정을 업데이트했습니다.

📌 구현 내용

  1. Swagger 설정 수정(src/docs/swagger/options.ts)
  • 로컬(ts-node)뿐만 아니라 빌드된 환경에서도 JSDoc을 읽을 수 있도록 apis 경로에 ./dist/**/*.js를 추가했습니다.
  1. Caddy 리버스 프록시 설정 (Caddyfile)
  • promptplace.kr, www.promptplace.kr 도메인 설정을 추가했습니다.
  • /api-docs 경로에 와일드카드(*)를 적용하여 Swagger 관련 정적 리소스(CSS, JS)가 정상적으로 로딩되도록 수정했습니다.

📌 구현 결과

배포 서버에서 더 이상 "No operations defined"가 뜨지 않고 API 목록이 정상적으로 노출됩니다.

📌 논의하고 싶은 점

서버에서 급하게 수정했던(Hotfix) 사항을 코드로 반영하여 싱크를 맞췄습니다.

@Arin0303 Arin0303 self-assigned this Jan 1, 2026
@Arin0303 Arin0303 added the fix fixing codes label Jan 1, 2026
@Arin0303 Arin0303 merged commit 72d3a57 into develop Jan 1, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

fix fixing codes

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant