기루 기룩 기록

build.gradle 설정 변경

...
plugins {
    id 'org.springframework.boot' version '3.0.0' // 3.0.0으로 변경
    ...
}
...

// Java version 변경
sourceCompatibility=17
targetCompatibility=17

assert System.properties["java.specification.version"] == "17"
...

gradle 버전업
gradle-wrapper.properties 설정 변경

distributionUrl=https\://services.gradle.org/distributions/gradle-7.5.1-bin.zip

active profile 설정 방법이 2.4 버전부터 변경됨

https://spring.io/blog/2020/08/14/config-file-processing-in-spring-boot-2-4#profile-activation

• profiles 설정 방법: spring.profiles에서 spring.config.on-profile로 변경됨
• include 설정 방법: spring.profiles.include에서 spring.profile.group로 설정

서버 실행 명령어

java -jar -Dspring.profiles.active=dev {SPRING_PROJECT}.jar

• 기존 application-dev.yml 설정

spring:
  profiles: dev
  profiles.include:
      - swagger

• 변경

# application.yml
spring:
  profiles:
    group:
      dev: swagger,debug
      test: swagger
---
# application-dev.yml
spring:
  config:
    activate:
      on-profile: dev
  datasource:
    ...
---
# application-test.yml
spring:
  config:
    activate:
      on-profile: test
  datasource:
    ...
---
# application-prod.yml
spring:
  config:
    activate:
      on-profile: prod
  datasource:
    ...

spring boot 3.0부터는 javax.*이 대신 Jakarta EE 9 API()를 사용

javax를 jakarta로 변경해주기만 하면 됨

// 기존
import javax.servlet.??

// 변경
import jakarta.servlet.??

In Spring Security 5.7.0-M2 we deprecated the WebSecurityConfigurerAdapter,
as we encourage users to move towards a component-based security configuration.

Spring Security 5.7.0-M2부터 WebSecurityConfigurerAdapter을 더이상 사용할 수 없음
자세한 해결 방법은 아래 링크 참조하면 되며 간단히 수정한 내용을 작성함

https://spring.io/blog/2022/02/21/spring-security-without-the-websecurityconfigureradapter

1. WebSecurity config 설정 변경
WebSecurityCustomizerbean을 등록하는 것입니다.
* 5.8에서 변경된 내용 web.ignoring().antMatchers -> web.ignoring().requestMatchers

// 기존
@Override
public void configure(WebSecurity web) throws Exception {
    web.ignoring().antMatchers(HttpMethod.OPTIONS, "/**");
}

// 변경
@Bean
public WebSecurityCustomizer configure() throws Exception {
    // web.ignoring().antMatchers(HttpMethod, "")
	// -> web.ignoring().requestMatchers(HttpMethod, "")
    return (web) -> web.ignoring().requestMatchers(HttpMethod.OPTIONS, "/**");

}

2. HttpSecurity config 설정 변경  (수정필요)
SecurityFilterChainbean을 직접 등록하는 방식으로 변경
 * 5.5에서 변경된 내용 HttpSecurity.authorizeRequests() -> HttpSecurity.authorizeHttpRequests()

// 기존
@Override
protected void configure(HttpSecurity http) throws Exception {
    http
        .authorizeHttpRequests((authorize) -> authorize
         // .antMatchers(ApiConstants.SAMPLE).hasAnyAuthority(AuthEnum.ADMIN.getName)
            .anyRequest().authenticated()
        )
        .httpBasic(withDefaults());
}

// 변경
@Bean
public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
    http
        .authorizeHttpRequests((authorize) -> authorize
         // .requestMatchers(ApiConstants.SAMPLE).hasAnyAuthority(AuthEnum.ADMIN.getName)
            .anyRequest().authenticated()
        )
        .httpBasic(withDefaults());
    return http.build();
}

3. UrlAuthorizationConfigurer.AuthorizedUrl.access -> AuthorizeHttpRequestsConfigurer.AuthorizedUrl.access
attribute 문자열을 통해 권한을 부여하는 방식이 변경됨
access(String attribute) -> access(AuthorizationManager<RequestAuthorizationContext> manager)

API별 권한 부여방식이 변경됨
antMatchers -> requestMatchers

// 기존
@Override
protected void configure(HttpSecurity http) throws Exception {
    http
        ...
        .authorizeRequests()
        	.antMatchers("/api/v1").access("permitAll()")
        ...
 }
// 변경
@Bean
protected SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
    http
        ...
        .authorizeHttpRequests((authorize) ->
			authorize.requestMatchers("/api/v1")
				.access(new WebExpressionAuthorizationManager("permitAll()"))
        ...
	return http.build();
 }

properties 암호화로 사용하던 Jasypt가 동작을 안하는 오류가 발생했다..

원인은 3.0버전부터 auto-configuration 설정파일의 형식이 변경됐기 때문
기존: META-INF/spring.factories에 원하는 configuration 정의
변경: META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports에 정의

3.0에서 변경된 auto-configuration 등록 방법에 대응하기 위해선 라이브러리에 변경사항이 반영돼야 함

다음 이슈를 참고해 강제로 auto-configuration을 등록해 해결함
- https://github.com/ulisesbocchio/jasypt-spring-boot/issues/342

@ImportAutoConfiguration(classes = JasyptSpringBootAutoConfiguration.class) // Remove when Jasypt is released for spring boot 3 (or at least 2.7)
@SpringBootApplication
public class SampleApplication {
    ...
}

Spring boot 3.0으로 마이그레이션하니 swagger-ui가 동작하지 않게됨
springfox git을 가보니 나만 그런게 아니라 안심이 됐다(?)

• https://github.com/springfox/springfox/issues/4040
• https://github.com/springfox/springfox/issues/4041

springdoc 공식 사이트에선 springdoc-openapi v2를 사용하면 3.0에서 사용 가능하다고하니
갈아탈 준비를 해야겠다..
우선 swagger-ui를 사용한 API doc 수정은 우선순위를 미루기로 결정