Sửa lỗi Spring Boot: Các loại ký tự khác nhau và kiểu Smallint không có toán tử

Những cạm bẫy thường gặp với các truy vấn SQL khởi động mùa xuân: Xử lý các loại không khớp trong PostgreSQL

Là nhà phát triển, tất cả chúng ta đều gặp phải những thông báo lỗi khó hiểu dường như không biết từ đâu xuất hiện. Một phút, của chúng tôi Ứng dụng khởi động mùa xuân đang chạy trơn tru; tiếp theo, chúng tôi đang xử lý lỗi về các loại dữ liệu không tương thích. 😅 Điều đó vừa khó chịu vừa bối rối, đặc biệt là khi xử lý các thiết lập truy vấn phức tạp.

Gần đây tôi gặp phải lỗi PostgreSQL trong Spring Boot: "toán tử không tồn tại: ký tự thay đổi = Smallint." Thông báo này xuất hiện trong khi cố gắng sử dụng Tập hợp các enum trong mệnh đề IN của truy vấn SQL. Sự không khớp giữa loại enum và loại cột cơ sở dữ liệu đã tạo ra một trục trặc không mong muốn trong đoạn mã có vẻ đơn giản.

Mặc dù việc đổ lỗi cho các lỗi cơ sở dữ liệu hoặc Spring Boot là điều rất dễ xảy ra, nhưng vấn đề thực sự thường nằm ở cách ánh xạ các enum và loại cơ sở dữ liệu. Các enum Java, khi được ánh xạ tới cơ sở dữ liệu, yêu cầu xử lý đặc biệt, đặc biệt là với PostgreSQL. Hiểu những chi tiết này có thể tiết kiệm thời gian và ngăn ngừa các sự cố trong tương lai khi làm việc với enum trong Spring Boot.

Trong hướng dẫn này, tôi sẽ giải thích cách tôi xác định vấn đề và tìm ra giải pháp thực tế. Từ hành trình gỡ lỗi của riêng tôi đến các bản sửa lỗi mã cụ thể, bạn sẽ có được các công cụ cần thiết để tránh lỗi gõ không khớp trong truy vấn của mình và đảm bảo tương tác cơ sở dữ liệu liền mạch. 🔧

Giải quyết các kiểu dữ liệu không khớp trong Spring Boot bằng PostgreSQL

Khi làm việc với Khởi động mùa xuân và PostgreSQL, các nhà phát triển thường gặp phải vấn đề về kiểu không khớp, đặc biệt là với enum. Trong trường hợp này, lỗi "toán tử không tồn tại: ký tự thay đổi = smallint" xảy ra do PostgreSQL không thể diễn giải trực tiếp một enum Java dưới dạng một kiểu SQL trong các truy vấn gốc. Ở đây, thực thể SystemAccounts bao gồm trường userCode được biểu thị bằng enum AccountType, ánh xạ các giá trị như "PERSONAL" hoặc "CORPORATE" trong Java. Tuy nhiên, khi thử truy vấn SQL gốc bằng Tập hợp các enum, PostgreSQL không thể tự động khớp các loại enum, dẫn đến lỗi này. Để khắc phục điều này, điều quan trọng là phải chuyển đổi enum thành chuỗi trước khi chuyển nó vào truy vấn. 🎯

Trong giải pháp được cung cấp, chúng tôi bắt đầu bằng cách điều chỉnh ánh xạ enum trong SystemAccounts bằng cách sử dụng chú thích @Enumerated(EnumType.STRING). Điều này hướng dẫn JPA lưu trữ từng AccountType dưới dạng một chuỗi có thể đọc được thay vì số thứ tự. Đó là một thay đổi nhỏ nhưng nó đơn giản hóa việc xử lý dữ liệu trong tương lai bằng cách tránh các giá trị số, điều này sẽ khiến việc gỡ lỗi trong cơ sở dữ liệu trở nên phức tạp. Trong kho lưu trữ của chúng tôi, sau đó chúng tôi có thể sử dụng chú thích @Query tùy chỉnh để chỉ định logic SQL. Tuy nhiên, vì PostgreSQL vẫn cần enum dưới dạng chuỗi trong truy vấn nên chúng ta cần xử lý các giá trị AccountType thành định dạng chuỗi trước khi chuyển chúng vào.

API CriteriaBuilder cung cấp giải pháp động cho vấn đề này. Sử dụng CriteriaBuilder, chúng ta có thể tránh SQL gốc bằng cách xây dựng các truy vấn theo chương trình trong Java. Cách tiếp cận này cho phép chúng tôi thêm các bộ lọc enum mà không cần viết SQL bằng tay, điều này giúp giảm lỗi SQL và giúp bảo trì. Trong tập lệnh của mình, chúng tôi tạo danh sách các điều kiện Vị ngữ dựa trên giá trị chuỗi của từng enum, sử dụng cb.equal() để khớp với từng AccountType trong Tập hợp. Sau đó, cb.or() kết hợp các vị từ này, cho phép nhiều giá trị trong cùng một truy vấn. Thiết lập linh hoạt này quản lý động việc chuyển đổi enum thành chuỗi, giảm thiểu các vấn đề tương thích với PostgreSQL.

Cuối cùng, giải pháp kết hợp thử nghiệm đơn vị để xác minh tính tương thích. Bằng cách sử dụng JUnit, chúng tôi xác nhận rằng mỗi AccountType hoạt động với truy vấn của chúng tôi, xác thực rằng trường userCode có thể lưu trữ các giá trị "CÁ NHÂN" hoặc " CÔNG TY" và truy xuất chúng mà không gặp lỗi. Phương pháp thử nghiệm này trước tiên sẽ thiết lập các giá trị AccountType bắt buộc và chạy truy vấn findAllByUserCodes() để kiểm tra kết quả. Việc thêm các kiểm tra khẳng địnhNotNull() và khẳng địnhTrue() đảm bảo chúng tôi không gặp phải các giá trị rỗng hoặc không chính xác, đảm bảo giải pháp của chúng tôi xử lý mọi trường hợp một cách hiệu quả. Với thiết lập này, ứng dụng được chuẩn bị tốt hơn để xử lý các truy vấn enum trong nhiều điều kiện khác nhau trong sản xuất. 🧪

// Problem: PostgreSQL expects specific data types in queries.
// Solution: Convert enums to strings for query compatibility with PostgreSQL.
// This Spring Boot backend solution is clear, optimized, and includes type checks.

@Entity
@Table(name = "system_accounts")
@Getter
@Setter
public class SystemAccounts {
    @Id
    @Column(name = "id", nullable = false)
    private UUID id;
    @Column(name = "user_code")
    private String userCode;  // Store as String to avoid type mismatch
}

// Enumeration for AccountType
public enum AccountType {
    PERSONAL,
    CORPORATE
}

// Repository Query with Enum Handling
@Query(value = """
    SELECT sa.id FROM system_accounts sa
    WHERE sa.user_code IN :accountTypes""", nativeQuery = true)
Optional<List<SystemAccounts>> findAllByUserCodes(@Param("accountTypes") List<String> accountTypes);
// This query accepts a List of strings to avoid casting issues.

// Convert AccountType enums to Strings in Service
List<String> accountTypeStrings = accountTypes.stream()
    .map(Enum::name)
    .collect(Collectors.toList());

// Using CriteriaBuilder to dynamically handle enums in queries with automatic type checking.
// This approach uses Java’s Criteria API to avoid type mismatches directly in the code.

public List<SystemAccounts> findAllByUserCodes(Set<AccountType> accountTypes) {
    CriteriaBuilder cb = entityManager.getCriteriaBuilder();
    CriteriaQuery<SystemAccounts> query = cb.createQuery(SystemAccounts.class);
    Root<SystemAccounts> root = query.from(SystemAccounts.class);
    Path<String> userCodePath = root.get("userCode");
    List<Predicate> predicates = new ArrayList<>();

    // Add predicates for enum values, converting to String for matching
    for (AccountType type : accountTypes) {
        predicates.add(cb.equal(userCodePath, type.name()));
    }

    query.select(root)
         .where(cb.or(predicates.toArray(new Predicate[0])));
    return entityManager.createQuery(query).getResultList();
}

// This JUnit test ensures both solutions handle enums correctly with PostgreSQL.
// Tests database retrieval for both AccountType values: PERSONAL and CORPORATE.

@SpringBootTest
public class SystemAccountsRepositoryTest {
    @Autowired
    private SystemAccountsRepository repository;

    @Test
    public void testFindAllByUserCodes() {
        Set<AccountType> accountTypes = Set.of(AccountType.PERSONAL, AccountType.CORPORATE);
        List<SystemAccounts> results = repository.findAllByUserCodes(accountTypes);

        // Verify results are returned and types match
        assertNotNull(results);
        assertTrue(results.size() > 0);
        results.forEach(account ->
            assertTrue(account.getUserCode().equals("PERSONAL") || account.getUserCode().equals("CORPORATE"))
        );
    }
}

Xử lý chuyển đổi Enum thành chuỗi trong PostgreSQL bằng Spring Boot

Khi sử dụng Khởi động mùa xuân với PostgreSQL, việc xử lý các enum trong các truy vấn cơ sở dữ liệu thường đòi hỏi sự chú ý đặc biệt, đặc biệt khi các enum có liên quan đến truy vấn SQL gốc. Theo mặc định, PostgreSQL không hỗ trợ trực tiếp các enum Java mà thay vào đó mong đợi một kiểu dữ liệu tương thích như varchar hoặc chữ trong các truy vấn. Ví dụ: khi chúng ta cần lọc kết quả dựa trên một enum như AccountType, PostgreSQL yêu cầu chúng ta chuyển đổi enum Java thành giá trị chuỗi trước khi thực hiện truy vấn. Việc chuyển đổi này ngăn ngừa lỗi phổ biến "toán tử không tồn tại", xảy ra khi cơ sở dữ liệu cố gắng so sánh một enum với loại không tương thích như smallint hoặc ký tự khác nhau.

Một cách để giải quyết vấn đề này là tận dụng @Enumerated(EnumType.STRING) chú thích trong Spring Boot, lưu trữ enum dưới dạng giá trị chuỗi trực tiếp trong cơ sở dữ liệu. Tuy nhiên, đối với các tình huống liên quan đến truy vấn gốc, thường cần phải chuyển đổi enum thành chuỗi trong chính truy vấn đó. Bằng cách sử dụng các phương pháp như .stream() Và map(Enum::name), chúng ta có thể tạo danh sách biểu diễn chuỗi cho các giá trị enum của mình, sau đó có thể được chuyển tới PostgreSQL mà không gặp bất kỳ vấn đề nào về kiểu không khớp. Cách tiếp cận này đảm bảo tính linh hoạt, cho phép chúng tôi lọc theo nhiều giá trị AccountType một cách liền mạch mà không gặp lỗi.

Đối với các ứng dụng có cách sử dụng enum phức tạp hơn, một cách tiếp cận khác là sử dụng CriteriaBuilder API, cho phép chúng tôi tự động xây dựng các truy vấn theo cách an toàn về loại mà không cần viết SQL theo cách thủ công. API này đặc biệt hữu ích để tạo mã có thể tái sử dụng và mã bất khả tri về cơ sở dữ liệu, vì nó tự động chuyển các enum thành các loại cơ sở dữ liệu tương thích, giảm nguy cơ lỗi loại. Với phương pháp này, quy trình xây dựng truy vấn được đơn giản hóa và các nhà phát triển có được sự linh hoạt để xử lý các bộ lọc dựa trên enum khác nhau theo cách thống nhất.