Servlet.service() for servlet [dispatcherServlet] in context with path [] threw exception [Request processing failed: org.springframework.dao.InvalidDataAccessApiUsageException: Executing an update/delete query] with root cause

jakarta.persistence.TransactionRequiredException: Executing an update/delete query
at org.hibernate.internal.AbstractSharedSessionContract.checkTransactionNeededForUpdateOperation(AbstractSharedSessionContract.java:517) ~[hibernate-core-6.4.4.Final.jar:6.4.4.Final]
at org.hibernate.query.sqm.internal.QuerySqmImpl.executeUpdate(QuerySqmImpl.java:671) ~[hibernate-core-6.4.4.Final.jar:6.4.4.Final]
at cohttp://m.querydsl.jpa.impl.JPAUpdateClause.execute(JPAUpdateClause.java:76) ~[querydsl-jpa-5.1.0-jakarta.jar:na]

위와 같은 오류가 발생했을 때 transaction이 없어서 발생하는 오류로 update queryDSL에 @Transactional 선언을 하면 해결된다.

No validator could be found for constraint 'jakarta.validation.constraints.NotEmpty' validating type

@NotEmpty를 이용해서 validation check를 하고 있었는데 empty의 경우 컬렉션 또는 문자열 타입만 사용할 수 있다.

객체에 @NotEmpty를 사용해서 에러 발생 -> @NotNull로 변경

com.fasterxml.jackson.databind.exc.UnrecognizedPropertyException: Unrecognized field "totalMemberBankDcPrice" (class com.fassto.godomallorderapi.domain.order.dto.response.godomall.GodomallOrderResponse), not marked as ignorable (63 known properties: "depositor", "totalCouponOrderDcPrice", "orderGoodsNm", "memGroupNm", "totalCouponDeliveryDcPrice", "orderTypeFl", "realTaxFreePrice", "orderIp", "useDeposit", "orderDate", "orderGoodsCnt", "orderInfoDataList", "pushCode", "totalDeliveryCharge", "realTaxSupplyPrice", "orderNo", "orderGoodsDataList", "apiOrderNo", "paymentDt", "totalGoodsDcPrice", "totalMyappDcPrice", "idx", "settlePrice", "mallSno", "useMileage", "totalDeliveryInsuranceFee", "overseasSettlePrice", "memId", "taxFreePrice", "accountNumber", "addField", "orderStatus", "totalMemberOverlapDcPrice", "orderGoodsNmStandard", "appOs", "totalMileage", "bankName", "orderDeliveryDataList", "taxVatPrice", "totalMemberMileage", "realTaxVatPrice", "orderEmail", "taxSupplyPrice", "orderGoodsData", "overseasSettleCurrency", "memNo", "totalGoodsPrice", "totalGoodsMileage", "giftData", "orderChannelFl", "totalCouponGoodsDcPrice", "statisticsAppOrderCntFl", "totalMemberDcPrice", "giftDataList", "firstSaleFl", "totalCouponGoodsMileage" [truncated]])
 at [Source: (StringReader); line: 231, column: 14] (through reference chain: com.fassto.godomallorderapi.domain.order.dto.response.godomall.OrderReturnRoot["return"]->com.fassto.godomallorderapi.domain.order.dto.response.godomall.OrderSearchResponse["order_data"]->java.util.ArrayList[0]->com.fassto.godomallorderapi.domain.order.dto.response.godomall.GodomallOrderResponse["totalMemberBankDcPrice"])
	at com.fasterxml.jackson.databind.exc.UnrecognizedPropertyException.from(UnrecognizedPropertyException.java:61) ~[jackson-databind-2.17.1.jar:2.17.1]

JSON에는 totalMemberBankDcPrice 값이 존재하지만 매핑 대상이 되는 Class에 해당 field가 존재 하지 않아서 데이터를 맵핑시키지 못해 발생하는 현상

=> Class에 @JsonIgnoreProperties(ignoreUnkown = true)를 추가하여 매핑되지 않는 값은 무시하도록 설정

java.io.NotSerializableException: com.fassto.godomallorderapi.domain.order.dto.response.godomall.OrderGoodsData

java.io.NotSerializableException: com.fassto.godomallorderapi.domain.order.dto.response.godomall.OrderGoodsData

Serializable을 implement 상속하지 않아서 발생한 오류

[PersistenceUnit: default] Unable to build Hibernate SessionFactory; nested exception is org.hibernate.MappingException: Repeated column in mapping for entity: com.fassto.godomallorderapi.domain.order.entity.GodomallOrd column: gdm_goods_no (should be mapped with insert="false" update="false")

복사를 통해 속성값 추가하다가 @Columns(name="gdm_goods_no")도 동일하게 추가해서 동일한 컬럼명이 존재해서 발생한 오류

신규 프로젝트를 진행하는데 

Spring Boot 2 -> 3으로 변경하면서 JAVA 17버전으로 올리는 것도 진행했다.

기존 프로젝트의 설정을 그대로 사용하지 않고 새로 set up을 했는데 그 과정에서 별 것도 아닌데 많은 오류를 만나게 되었다.

이전엔 아래와 같이 작업했는데 

오류 - 'url' attribute is not specified and no embedded datasource could be configured.Reason: Failed to determine suitable jdbc url

spring:
  datasource:
    hikari:
      jdbc-url: jdbc:log4jdbc:mariadb:/localhost:3306
      username: 
      password: 
      driver-class-name: net.sf.log4jdbc.sql.jdbcapi.DriverSpy
      maximum-pool-size: 4
      minimum-idle: 1
      connection-timeout: 60000
      max-lifetime: 60000

Spring 2.7.2 버전

spring:
  datasource:
    url: 
    username: 
    password:
    driver-class-name: net.sf.log4jdbc.sql.jdbcapi.DriverSpy
    hikari:
      maximum-pool-size: 4
      minimum-idle: 1
      connection-timeout: 60000
      max-lifetime: 60000

Spring 3.2.5 버전

@Bean
@ConfigurationProperties(prefix = "spring.datasource")
fun dataSourceProperties(): DataSourceProperties {
    return DataSourceProperties()
}

@Bean
@ConfigurationProperties(prefix = "spring.datasource.hikari")
fun dataSource(dataSourceProperties: DataSourceProperties): HikariDataSource {
    // HikariDataSource를 사용하기 위해 Hikari 설정 객체를 생성자로 넣은 HikariDataSource 객체 반환
    val dataSource: HikariDataSource =
        dataSourceProperties.initializeDataSourceBuilder().type(HikariDataSource::class.java).build()
    if (StringUtils.hasText(dataSourceProperties.name)) {
        dataSource.poolName = dataSourceProperties.name
    }
    return dataSource
}

기존엔 @ConfigurationProperties(prefix = "spring.datasource.hikari") 하나의 bean만 생성하여 HikariDataSource type의 클래스를 리턴하도록 하였는데 Spring Boot 버전이 올라가면서 설정하는 방식이 변경된 것 같다.

spring.datasource에 해당하는 빈을 만들고 spring.datasource.hikari 빈을 만들면서 만들어놓은 datasource를 hikariDataSource type으로 초기화하면서 dataSource를 반환하도록 했다.

오류 - Driver net.sf.log4jdbc.sql.jdbcapi.DriverSpy claims to not accept jdbcUrl, jdbc:log4jdbc:mariadb://istg15-db.fassto.ai:3306/fsswms?useUnicode=true&characterEncoding=utf8mb4&autoReconnect=true&allowMultiQueries=true

driverClass에 해당하는 JDBC가 없을 때 발생한다.

기존에는 mariadb를 사용할 때 mysql(runtimeOnly 'mysql:mysql-connector-java')을 JDBC로 사용해도 문제가 없었는데 Spring Boot 3으로 올리면서 엄격하게 타입 체크를 하는 것 같다.

mariadb(runtimeOnly("org.mariadb.jdbc:mariadb-java-client:3.3.2"))로 JDBC를 변경하니 오류 없이 DB 세팅은 완료되었다.

Spring Boot 3이 되면서 datasource 관련된 설정 방식이 기존과 다르게 많이 변경된 것 같다.

이번에 또 느낀게 인터넷에 있는 설정들은 내 작업물과 100% fit하지 않기 때문에 본인 설정 방식에 맞는 것을 오류 메시지를 통해서 파악해야한다!

• 오류 메시지
  • org.springframework.web.util.NestedServletException: Handler dispatch failed; nested exception is java.lang.NoClassDefFoundError: org/reactivestreams/Publisher
• 원인
  • spring-boot-starter-webflux dependency 누락
• 해결
  
  • spring-boot-starter-webflux dependency 추가

• 오류 메시지
  • java.lang.ArithmeticException: Rounding needed with the rounding mode being set to RoundingMode.UNNECESSARY
• 상황
  • 통화 포맷 작업 중 소수점 표현을 위해 RoundingMode.UNNECESSARY 사용
• 내용
  • 반올림 없이 정확하게 표현할 수 없는 경우에서 RoundingMode.UNNECESSARY를 지정하면 예외가 발생.
  • 따라서 이 경우에는 반올림 없이 표현할 수 없기 때문에 RoundingMode.UNNECESSARY가 아닌 다른 방법을 사용해야 함.
  • 이 예외를 방지하려면 필요에 맞는 다른 반올림 모드(예: RoundingMode.HALF_UP 또는 RoundingMode.DOWN)를 사용하거나 BigDecimal 값을 설정하기 전에 원하는 배율로 정확하게 표현할 수 있는지 확인후 사용할 것.

오류 메시지: org.springframework.dao.InvalidDataAccessApiUsageException: For input string: "XXX"; nested exception is java.lang.NumberFormatException: For input string: "XXX"

상황: jpa repository를 통한 조회를 시도하고 있었고, entity 안에서 Enum 클래스를 사용하고 있던 상황에 발생한 오류

해결: Entity의 해당 enum에 @Enumerated(EnumType.STRING) 어노테이션 추가로 해결

보통 Caused by: java.sql.SQLSyntaxErrorException: Unknown column 'blackliste0_.createDate' in 'field list' 처럼 원인에 대한 메시지가 하나 더 있습니다.

이 예외는 SQL 쿼리 또는 엔터티 매핑에 문제가 있음을 나타냅니다.

몇 가지 가능한 원인은 다음과 같습니다.

• 쿼리 또는 테이블 name에 예약된 키워드를 사용하고 있습니다.
• 엔티티 class에서 열 주석 또는 getter/setter 메소드가 누락되었습니다.
• 열 또는 매개변수에 대해 잘못된 데이터 유형 또는 길이를 사용하고 있습니다.

다음을 통해 이 예외를 수정할 수 있습니다.

• 백틱(`)을 사용하여 예약된 키워드를 이스케이프 처리하거나 다른 이름으로 변경.
• 엔티티 클래스에 누락된 주석 또는 메소드 추가.
• 열 또는 매개변수의 데이터 유형과 길이를 확인하고 데이터베이스 스키마와 일치하는지 확인.

SQL의 예약 키워드는 SQL 언어에서 특별한 의미나 기능을 가진 단어입니다. 데이터베이스를 정의, 조작 및 액세스하는 데 사용됩니다.

예를 들어 SELECT, DELETE 또는 BIGINT는 SQL에서 예약된 키워드입니다.

테이블 이름이나 열 이름과 같은 식별자나 개체 이름으로 예약된 키워드를 사용하면 오류나 혼란이 발생할 수 있습니다.

이를 방지하려면 예약 키워드가 아닌 다른 이름을 사용하거나 구분 식별자를 사용하여 예약 키워드를 따옴표나 대괄호로 묶을 수 있습니다.

다른 SQL 제품에는 다른 예약 키워드 세트가 있을 수 있으므로 SQL 제품 설명서를 확인하여 버전에 대한 예약 키워드 목록을 확인해야 합니다.

Cannot deserialize value of type `java.util.ArrayList<~>` from Object value (token `JsonToken.START_OBJECT`)

• RestAPI 호출 후 리턴받은 JSON 데이터와 소스 상에 리턴받는 형태가 맞지 않을 때 해당 오류 발생
• API 규격서 확인하여 리턴받는 Type 확인

기존 자바 8을 사용하던 프로젝트에서 java 11로 변경하고 빌드도구도 maven에서 gradle로 변경하면서 나름 다양한 오류를 만나게 되었다.  * 사용하고자 하는 자바 버전이 사전에 설치되어있어야한다.

1. source release 11 requires target release 11 

java 11을 사용하겠다고 gradle에 sourceCompatibility(자바소스 컴파일 버전 명시) = '11'로 명시 

이전에 시스템 환경에서 사용되는 건 8버전이었기 때문에 변경 작업이 필요

File - Project Structure - Project Settings-Project에서 Language level : 사용하고자 하는 자바버전으로 변경

File - Project Structure - Project Settings-Modules에서 모듈 추가 후 Language level : 사용하고자 하는 자바 버전으로 변경

위와 같이 변경했는데도 안 되면 Settings-Build, Execution~ - Java Compiler에서 module추가 후 Target bytecodeVersion을 사용하고자 하는 버전으로 변경하면 된다.

maven 프로젝트를 gradle로 전환하면서 마주친 오류는 main, test의 java폴더를 소스 루트로 인식하지 못하는 오류가 있었다. Cannot find or load main class 오류 발생. 그래서 대상이 되는 java 패키지 폴더를 우클릭하고 Source Root로 변환해주는 작업을 했다.

yaml파일을 통한 @value값 설정 시 static일 경우 값 설정이 정상적으로 되지 않는 오류 발생. null값으로 세팅됨. - 값이 할당되는 시점 차이로 보여 해당 현상 파악할 예정

또한 기존의 프로젝트 파일을 그대로 가져다 쓰면서 Cloud not resolve type alias '패키지명.클래스명'의 오류가 발생하여 

yaml 설정 파일 중 아래의 type-aliases-package 경로를 현재 프로젝트의 경로로 변경

casting 형 변환 오류로 대게 잘못된 형변환를 하려고 할 경우에 발생한다. 내 경우에는 hashMap에 담은 Object를 String으로 형 변환하려 (String)map.get("fruit")을 사용했을 때 해당 오류를 마주했다. 

hashMap에 담긴 Integer Object를 String으로 변경하고자 할 땐 String.valueOf(map.get("fruit"))을 사용해야 형변환 오류 없이 안정적으로 필요한 값을 뽑을 수 있다.

해당 내용에 대한 자세한 설명이 궁금해서 인터넷 및 Java API 문서를 보고 확인했더니 아래의 내용을 확인할 수 있었다.

(String)을 사용하려는 object가 String인 경우에만 casting이 가능하면 String이 아닐 경우 ClassCastException이 발생한다.

Object sumQty = new Integer(9);
String str = (String) sumQty; // ClassCastException 발생

String object의 경우 오류없이 casting이 정상적으로 진행되어 오류가 발생하지 않는다.

Object reallyAString = "today";
String str = (String) reallyAString;

String.valueOf()는 String으로 변경하려는 대상의 타입이 무엇이든지 상관없이 String형으로 변경해준다. String.valueOf()는 원시타입(primitive type), object (Integer, Boolean, char 등 해당 Object의 toString()을 사용) 둘 다 다룰 수 있습니다.