Part of your World

#### 발생 원인:

- **타입 불일치**: 쿼리 결과에서 `employeesName` 컬럼은 문자열 타입인데, 해당 컬럼을 `int`로 처리하려고 시도하여 `SQLException`이 발생.
    - **에러 메시지**:

1. ResultSet.getInt(employeesName) java.sql.SQLException: Out of range value for column 'employeesName': value 박현아

    - **문제**: `employeesName` 컬럼의 값이 실제로는 문자열(`"박현아"`)인데, 이를 `int`로 변환하려고 시도했기 때문에 타입 불일치 오류가 발생.

#### 영향 범위:

- **데이터 매핑 오류**: `employeesName` 값을 `int`로 처리하려고 시도했기 때문에 데이터 매핑이 올바르게 처리되지 않음. 이는 `employeesName`을 사용하는 모든 로직에서 오류를 발생시킴.
- **응답 실패**: 쿼리 결과를 처리하는 과정에서 `SQLException`이 발생하여 애플리케이션이 예상대로 동작하지 않음.
- **타입 불일치**: 데이터베이스 컬럼의 타입과 Java 모델 객체의 타입이 일치하지 않아서, 데이터를 가져오는 과정에서 오류가 발생.

#### 주요 프로세스 영향:

1. **데이터 조회 실패**:
    - `ResultSet.getInt()` 메소드에서 `employeesName` 값을 `int`로 읽으려 했지만, 컬럼이 문자열이므로 `SQLException`이 발생. 이로 인해 데이터 조회가 실패함.
2. **잘못된 모델 매핑**:
    - 모델 객체에서 `employeesName` 필드를 `int`로 선언한 경우, 데이터베이스에서 문자열 값을 올바르게 매핑할 수 없어서 오류가 발생.
3. **응답 지연**:
    - 쿼리 실행 중 오류가 발생하여 응답을 제대로 반환할 수 없게 되고, 클라이언트에 오류 응답이 전송됨.

#### 해결 방안:

1. **모델 수정**:
    
    - `employeesName` 컬럼의 값을 올바르게 처리할 수 있도록 모델 객체에서 `employeesName` 필드를 `String` 타입으로 변경.
    - **수정된 코드**:

private String employeesName;  // String 타입으로 수정

2. **타입 일치 검토**:
    
    - 데이터베이스 컬럼 타입과 Java 모델 타입이 일치하는지 항상 확인해야 하며, 쿼리 결과를 매핑할 때 타입 불일치가 발생하지 않도록 유의.
    - 문자열 값을 `int`로 변환하려고 할 경우, 해당 컬럼이 실제로 숫자 값임을 확인한 후 변환해야 합니다.
3. **테스트 및 검증**:
    
    - 모델 타입을 변경한 후, 데이터베이스에서 쿼리를 실행하고 모델 객체에 데이터를 제대로 매핑할 수 있는지 테스트.
    - 다양한 문자열 데이터를 테스트하여 오류가 발생하지 않는지 확인.
4. **로깅 및 예외 처리**:
    
    - `SQLException`이 발생할 가능성이 있는 경우, 적절한 예외 처리와 로깅을 추가하여 문제 발생 시 빠르게 원인을 추적할 수 있도록 함.
    - 예를 들어, `SQLException`을 잡아서 상세한 오류 메시지를 로깅할 수 있습니다.
5. **쿼리 최적화**:
    
    - 쿼리에서 필요한 컬럼만 선택적으로 조회하거나, 데이터 타입에 맞는 필드를 사용하여 쿼리 성능을 최적화할 수 있습니다.

#### 결론:

`employeesName` 컬럼의 값을 `int` 타입으로 처리하려고 시도하여 발생한 `SQLException`을 해결하기 위해, Java 모델 객체에서 `employeesName` 필드를 `String` 타입으로 변경해야 합니다. 이를 통해 데이터베이스에서 반환되는 문자열 값을 올바르게 처리할 수 있습니다. 타입 일치를 확인하고, 예외 처리를 적절히 적용하여 데이터 조회 오류를 예방해야 합니다.

### 에러 노트: NullPointerException - 포인트 값이 없을 경우

#### 발생 원인:

- **`NullPointerException` 발생**: `MobilePoint` 객체가 `null`일 경우, `point.getPoint()` 메소드 호출에서 `NullPointerException`이 발생.
    - **기존 코드**:

        return new PageImpl<>(list.getResults().stream()       
        .map(tuple -> {           
        MobileUsers data = tuple.get(userInfo);           
        MobilePoint point = tuple.get(userPoint);           
        return new MobileUserDTO.UserListData(               
        point.getPoint()          
        );       
        })       
        .collect(Collectors.toList()), pageable, list.getTotal());

        
    - **문제**: `point`가 `null`일 때 `point.getPoint()`를 호출하려고 해서 `NullPointerException`이 발생.
    - **해결 코드**:

        return new PageImpl<>(list.getResults().stream()       
            .map(tuple -> {           
            MobileUsers data = tuple.get(userInfo);           
        MobilePoint point = tuple.get(userPoint);           
        return new MobileUserDTO.UserListData(               
        point != null && point.getPoint() != null ? point.getPoint() : 0               
        // point가 null일 경우 0 반환           
        );       
        })       
        .collect(Collectors.toList()), pageable, list.getTotal());

#### 영향 범위:

- **NullPointerException**: `MobilePoint` 객체가 `null`일 경우, `point.getPoint()` 호출 시 예외가 발생하여 애플리케이션이 중단될 수 있음.
- **데이터 처리 오류**: `point`가 `null`인 경우에도 `getPoint()`를 안전하게 처리하지 않으면, 해당 사용자에 대한 데이터를 처리할 수 없거나, 오류가 발생하여 결과가 정상적으로 반환되지 않음.

#### 주요 프로세스 영향:

1. **데이터 조회 실패**:
    - `MobilePoint` 객체가 `null`인 경우, `point.getPoint()` 호출에서 오류가 발생하여, 해당 사용자의 정보가 잘못 처리되거나 조회되지 않음.
2. **응답 지연**:
    - 예외가 발생하여 요청이 실패하거나 예외 처리 로직으로 넘어가게 되어, 응답 시간이 지연될 수 있음.
3. **서비스 장애**:
    - `NullPointerException`으로 인해 서비스가 중단되거나, 일부 기능이 정상적으로 작동하지 않음.

#### 해결 방안:

1. **`null` 체크 추가**:
    
    - `MobilePoint` 객체가 `null`일 경우, `getPoint()`를 호출하지 않도록 `null` 체크를 추가하여 `NullPointerException`을 방지.
    - `point`가 `null`일 경우에는 기본 값(예: `0`)을 반환하도록 처리.
    - **수정된 코드**:

return new PageImpl<>(list.getResults().stream()       
  .map(tuple -> {           
  MobileUsers data = tuple.get(userInfo);           
  MobilePoint point = tuple.get(userPoint);           
return new MobileUserDTO.UserListData(               
point != null && point.getPoint() != null ? point.getPoint() : 0               
// point가 null일 경우 0 반환           
);       
})       
.collect(Collectors.toList()), pageable, list.getTotal());

        
2. **`Optional` 사용**:
    
    - `Optional`을 사용하여 `null` 처리를 더 안전하게 할 수 있음. 예를 들어, `point.getPoint()` 대신 `Optional.ofNullable(point).map(MobilePoint::getPoint).orElse(0)`와 같이 처리할 수 있음.
       

   return new PageImpl<>(list.getResults().stream()       
   .map(tuple -> {           
   MobileUsers data = tuple.get(userInfo);           
   MobilePoint point = tuple.get(userPoint);           
   return new MobileUserDTO.UserListData(               
   Optional.ofNullable(point).map(MobilePoint::getPoint).orElse(0)           
   );       
   })       
   .collect(Collectors.toList()), pageable, list.getTotal());

        
3. **테스트 및 검증**:
    
    - 수정된 코드가 정상적으로 동작하는지 확인하기 위해, `point`가 `null`인 경우와 아닌 경우에 대해 다양한 테스트를 진행.
    - 특히 `point`가 `null`일 때 결과가 `0`으로 반환되는지 검증.
4. **로깅**:
    
    - `point`가 `null`인 경우에 대한 로깅을 추가하여, 데이터가 `null`인 이유와 함께 문제를 추적할 수 있도록 함.
    - 예시:

if (point == null) {     
log.warn("MobilePoint is null for user: {}",data.getId()); 
}

#### 결론:

`MobilePoint` 객체가 `null`일 경우 `getPoint()` 메소드 호출에서 `NullPointerException`이 발생하는 문제를 해결하기 위해 `null` 체크를 추가하여 안전하게 처리하도록 수정해야 합니다. `Optional`을 사용하면 코드가 더 깔끔하고 안전하게 `null` 값을 처리할 수 있습니다. 이를 통해 애플리케이션이 중단되지 않고 정상적으로 데이터를 처리할 수 있습니다.

#### 발생 원인:

- **`unexpected token: with` 오류**: JPA 쿼리에서 `with` 구문을 잘못 사용하거나, 쿼리의 구조가 잘못되어 Hibernate가 쿼리를 올바르게 해석하지 못함. 오류 메시지에서 `unexpected token: with`가 나타나며, 이는 쿼리에서 잘못된 구문이 사용되었음을 나타냄.
    - **기존 코드**:

JPAQuery<Tuple> jpaQuery = queryFactory       
.select(userInfo, userPoint.point)       
.join(userPoint).on(userInfo.tokenId.eq(userPoint.tokenId))     
.from(userInfo);

        
    - **문제**: `from` 절이 잘못 배치되어 `join` 구문이 `with` 구문처럼 해석되는 문제가 발생. 이로 인해 Hibernate가 예상하지 못한 `with` 토큰을 만남.

    - **해결 코드**:

JPAQuery<Tuple> jpaQuery = queryFactory       
.select(userInfo, userPoint.point)       
.from(userInfo)       
.join(userPoint).on(userInfo.tokenId.eq(userPoint.tokenId));

        
    - **수정**: `from` 절을 쿼리의 처음에 배치하여 `join` 구문이 올바르게 해석되도록 수정.

#### 영향 범위:

- **쿼리 실행 오류**: `from`과 `join` 구문이 잘못 배치되어 쿼리가 Hibernate에서 실행되지 않음. 이로 인해 데이터 조회가 실패하고 애플리케이션에서 오류가 발생.
- **잘못된 쿼리 생성**: QueryDSL에서 쿼리의 구조가 잘못 설정되어, Hibernate가 쿼리를 올바르게 해석하지 못하고 `QuerySyntaxException`이 발생.

#### 주요 프로세스 영향:

1. **데이터 조회 실패**:
    - 잘못된 쿼리 구조로 인해 쿼리가 실행되지 않거나, SQL 구문 오류가 발생하여 결과가 반환되지 않음.
2. **서비스 오류**:
    - 쿼리 오류로 인해 해당 API 호출이 실패하고, 응답이 제대로 반환되지 않음.
3. **디버깅 어려움**:
    - Hibernate의 쿼리 해석 오류가 발생하면서 문제의 원인을 추적하기 어려울 수 있음.

#### 해결 방안:

1. **`from` 절의 위치 수정**:
    
    - `join` 구문을 사용할 때, `from` 절은 쿼리에서 먼저 선언되어야 하며, 그 후에 `join` 절을 추가해야 합니다.

    - **수정된 코드**:

JPAQuery<Tuple> jpaQuery = queryFactory       
.select(userInfo, userPoint.point)       
.from(userInfo)       
.join(userPoint).on(userInfo.tokenId.eq(userPoint.tokenId));

        
2. **QueryDSL 구문 체크**:
    
    - QueryDSL에서 쿼리를 작성할 때는 `from` 절이 항상 먼저 나오고, 그 후에 `join` 및 기타 절들이 나와야 한다는 점을 확인.
    - `select`와 `from` 구문을 올바르게 구성하여 쿼리의 실행 흐름을 맞춰야 합니다.
3. **쿼리 문법 검토**:
    
    - `select`와 `from` 절, `join` 구문을 사용하는 올바른 순서를 확인하고, Hibernate나 JPA에서 요구하는 쿼리 문법에 맞게 작성.
    - `with` 구문은 JPA에서 지원하지 않으므로, 쿼리 구조가 `with`를 포함하지 않도록 주의.
4. **쿼리 실행 전 테스트**:
    
    - 수정된 쿼리를 실행하기 전에 단위 테스트나 통합 테스트에서 쿼리가 정상적으로 실행되는지 검증.
    - 쿼리 로그를 활성화하여 실제 SQL 쿼리가 어떻게 변환되는지 확인하고, 오류가 없는지 점검.
5. **로깅 및 예외 처리**:
    
    - 쿼리 실행 시 오류가 발생할 경우, 자세한 로깅을 통해 문제를 추적하고, 문제 해결 후 정상적으로 데이터가 반환되는지 확인.