#441 [Fix] 광고 스웨거 기본 서버를 문서를 연 주소로 바꿈

[Roy-wonji]

문제

dev 스웨거에서 광고 API 를 Try it out 하면 401 이 떨어집니다.

https://dev.picke.store/swagger-ui/index.html?urls.primaryName=3.+광고+API
→ Execute
→ 401 AUTH_401 "인증이 필요합니다"

요청이 dev 가 아니라 운영으로 나가고 있었습니다. Swagger UI 는 서버 목록의 첫 번째를 기본으로 골라 두는데, 공통 목록이 운영을 맨 앞에 두고 있습니다.

1. https://picke.store      ← 기본 선택
2. http://localhost:8080
3. https://dev.picke.store

운영에는 광고 경로가 아직 배포되지 않아 JwtFilter 화이트리스트에 없고, 그래서 401 입니다.

요청 대상	결과
dev.picke.store/api/v1/ads?slot=HOME_FEED	200 {"statusCode":200,"data":[]}
picke.store/api/v1/ads?slot=HOME_FEED	401 AUTH_401

지금은 401 로 막히지만, 광고가 운영에 배포되면 같은 실수가 조용히 통과합니다. 광고 그룹에는 소재 등록·수정·삭제가 함께 묶여 있어 운영 데이터가 바뀝니다.

왜 프로파일로 가르지 않는가

prod 프로파일이면 운영, 아니면 dev 로 나누는 방법을 먼저 검토했습니다. 쓸 수 없습니다.

dev 서버도 prod 프로파일로 돕니다. 부팅 로그에 그대로 남아 있습니다.

The following 1 profile is active: "prod"     ← dev.picke.store 컨테이너

application-prod.yml 에도 호스트를 가르는 설정이 없습니다. 프로파일로 나누면 dev 스웨거가 운영을 가리키는 지금 상태가 그대로 유지됩니다.

변경

• 광고 그룹의 서버 목록 맨 앞에 상대 경로(/)를 둔다. Swagger UI 가 이를 현재 origin 으로 풀어 주므로, 운영에서 연 문서는 운영으로, dev 에서 연 문서는 dev 로 나간다.
• 절대 주소 세 개는 목록에 남겨 둔다. 다른 환경을 일부러 고르는 것은 그대로 가능하다.
• 다른 그룹(사용자·관리자·전체)의 서버 순서는 건드리지 않는다.
• 서버 정의가 두 곳에서 필요해져 메서드로 뽑았다. 값은 그대로다.
• 광고 그룹의 기본 서버와, 다른 그룹이 종전 순서를 유지하는지 검사하는 테스트를 추가한다.

검증

• ./gradlew test --tests "com.swyp.picke.domain.ad.*" --tests "com.swyp.picke.global.config.*" --rerun-tasks → BUILD SUCCESSFUL
• SwaggerAdGroupTest 4건 통과 (failures 0, errors 0)
• 역검증: 상대 경로를 빼고 운영 우선으로 되돌리면 해당 테스트 FAILED

남은 것

이 PR 범위 밖이라 손대지 않았습니다. 별도로 다룰지 판단이 필요합니다.

slot 파라미터를 빼면 400 이 아니라 500 이 납니다. 스웨거에서 파라미터를 채우지 않고 Execute 하면 이 응답을 보게 됩니다.

GET /api/v1/ads   → 500 COMMON_500 "서버 오류가 발생했습니다"

MissingServletRequestParameterException 이 전역 핸들러에 잡히지 않는 것으로 보입니다.