API 문서 접근 시 로그인 페이지로 리디렉션 오류

채정윤·2025년 5월 13일

Error

목록 보기
7/9

http://localhost:8081/swagger-ui.html 또는 http://localhost:8081/v3/api-docs 와 같은 API 문서 페이지에 접속하려고 할 때 http://localhost:8081/login 으로 리디렉션되는 문제!!

원인 :

Spring Security 설정

  • SecurityConfig.java에서 /api/auth/** 경로를 제외한 모든 요청(anyRequest().authenticated())에 인증을 요구
  • 인증되지 않은 접근은 formLogin 설정에 따라 로그인 페이지로 리디렉션시키기 때문
  • API 문서 관련 경로들(swagger-ui.html, v3/api-docs 등)이 permitAll()에 포함되어 있지 않아 발생하는 문제

해결 방법 :

SecurityConfig.java 파일의 filterChain 메소드 내

authorizeHttpRequests 설정에 API 문서 관련 경로들을 추가 → permitAll()을 적용

.requestMatchers(
                "/api/auth/**",
                "/swagger-ui.html",
                "/swagger-ui/**",
                "/v3/api-docs",
                "/v3/api-docs/**"
        ).permitAll()

이를 통해 해당 경로들은 인증 없이 접근 가능하게 됨

0개의 댓글