Spring Data JPA无法提取含byte[]头像的用户问题求助

问题概述 #

用户数据已成功保存到PostgreSQL数据库，但使用Spring Data JPA读取包含byte[]类型头像字段的用户时，抛出错误：

org.springframework.orm.jpa.JpaSystemException: Unable to extract JDBC value for position 6

错误指向profileImage字段，表明JPA无法提取该字节数组数据。

AppUser实体代码 #

@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
@Entity
public class AppUser implements UserDetails {
    @Id
    @SequenceGenerator(
            name = "appUser_sequence",
            sequenceName = "appUser_sequence",
            allocationSize = 1
    )
    @GeneratedValue(
            strategy = GenerationType.SEQUENCE,
            generator = "appUser_sequence"
    )
    private Integer id;
    private String firstname;
    private String lastname;
    private String email;
    private String password;

    @Lob
    private byte[] profileImage;
    private Role role;
    // 其余代码
}

用户查询代码 #

@Override
public AppUser loadUserByUsername(String email) throws UsernameNotFoundException {
    return repository.searchByEmail(email)
            .orElseThrow(() -> new UsernameNotFoundException("Email not found"));
}

用户注册代码（Base64转byte[]） #

public AuthenticationResponse register(RegistrationRequest registerRequest) {
    byte[] profileImageBytes = null;

    if (registerRequest.getProfileImageData() != null)
        profileImageBytes = Base64.getDecoder().decode(registerRequest.getProfileImageData());

    AppUser appUserToRegister = AppUser.builder()
            .firstname(registerRequest.getFirstname())
            .lastname(registerRequest.getLastname())
            .email(registerRequest.getEmail())
            .password(passwordEncoder.encode(registerRequest.getPassword()))
            .profileImage(profileImageBytes)
            .role(Role.USER)
            .build();

    appUserService.saveUser(appUserToRegister);

    String token = jwtService.generateToken(appUserToRegister);
    return new AuthenticationResponse(token);
}

解决方法 #

• 显式指定数据库列类型：在@Lob注解旁添加@Column注解，明确指定PostgreSQL的bytea类型，确保JPA与数据库字段类型匹配：

  @Lob
  @Column(columnDefinition = "bytea")
  private byte[] profileImage;
  

• 检查Hibernate版本兼容性：若使用Hibernate作为JPA提供者，确保版本与Spring Boot版本兼容，部分旧版本的Hibernate在处理byte[]类型时存在Bug，建议升级到稳定兼容版本。
• 避免懒加载影响：若实体存在关联关系的懒加载配置，确保查询用户时profileImage字段被显式加载，可在Repository的查询方法中添加fetch join或使用@EntityGraph强制加载该字段。
• 排查空值处理：确认数据库中profileImage字段的空值是否被正确处理，若允许空值，可在实体类中初始化profileImage为new byte[0]而非null，避免JPA读取空值时抛出异常。

内容的提问来源于stack exchange，提问作者leo___