...
Eroare Spring Boot · Spring Data JPA: entități și baza de date

Value too long for column "NUME CHARACTER VARYING(20)"

Pe scurt

Textul salvat are mai multe caractere decât lungimea coloanei (implicit 255, sau cât ai pus în @Column(length = ...)). Baza refuză inserarea cu DataIntegrityViolationException. Validează lungimea la intrare cu @Size(max = ...) și ține aceeași limită în entitate.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Coloanele text au o lungime maximă. În JPA, un câmp String devine implicit varchar(255), iar @Column(length = 20) îl face varchar(20). H2 afișează în mesaj coloana și tipul ei (CHARACTER VARYING(20)), de obicei urmate de începutul valorii respinse, ca să vezi ce text a fost prea lung.

În Spring eroarea ajunge ca DataIntegrityViolationException: could not execute statement [Value too long for column ...] și devine 500 dacă nu o tratezi. Pe PostgreSQL mesajul este value too long for type character varying(20), pe MySQL Data too long for column 'nume' at row 1.

Apare des la descrieri, adrese, comentarii sau URL-uri pe care nimeni nu le-a limitat la intrare. Repari în două locuri: limita din validare (@Size) și dimensiunea coloanei, care trebuie să fie cel puțin cât limita.

De ce apare: cauzele frecvente

1Nu limitezi lungimea la intrare

Greșit
JAVA
record ProdusNou(String nume) { }
Corect
JAVA
record ProdusNou(@Size(max = 20) String nume) { }

Fără @Size, un text de 50 de caractere trece de controller și pică abia în bază.

2Coloana e mai mică decât datele reale

Greșit
JAVA
@Column(length = 20)
private String descriere;
Corect
JAVA
@Lob
private String descriere;
// sau @Column(length = 2000)

Pentru texte lungi (descrieri, comentarii) alege o coloană potrivită de la început.

3Limita din validare nu corespunde cu coloana

Greșit
JAVA
@Size(max = 100) String nume   // DTO
@Column(length = 50) String nume // entitate
Corect
JAVA
@Size(max = 50) String nume     // DTO
@Column(length = 50) String nume // entitate

Dacă validarea permite mai mult decât coloana, textele dintre 51 și 100 de caractere ajung tot la eroarea din bază.

Repară tu

Repară eroarea, direct în pagină

Coloana nume are 20 de caractere, iar un nume mai lung dă Value too long for column la salvare (500). Limitează lungimea la intrare, ca un nume de peste 20 de caractere să primească 400, iar unul normal să se salveze.

Codul care dă eroarea
JAVA
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.data.jpa.repository.*;
import jakarta.persistence.*;
import jakarta.validation.Valid;
import jakarta.validation.constraints.Size;
import org.springframework.web.bind.annotation.*;
import java.util.*;

@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

@Entity
class Categorie {
    @Id
    @GeneratedValue
    private Long id;
    @Column(length = 20)
    private String nume;

    protected Categorie() {
    }

    Categorie(String nume) {
        this.nume = nume;
    }

    public Long getId() { return id; }
    public String getNume() { return nume; }
}

record CategorieNoua(String nume) { }

interface CategorieRepository extends JpaRepository<Categorie, Long> {
}

@RestController
class CategorieController {
    private final CategorieRepository repo;

    CategorieController(CategorieRepository repo) {
        this.repo = repo;
    }

    @PostMapping("/categorii")
    Categorie adauga(@RequestBody CategorieNoua c) {
        return repo.save(new Categorie(c.nume()));
    }
}
După reparație, programul afișează
Tomcat started on port 8080 (http)
Started Application
POST /categorii → 400
{"status":400,"error":"Bad Request","message":"Validation failed for object='categorieNoua'. Error count: 1","path":"/categorii"}
POST /categorii → 200
{"id":1,"nume":"Periferice"}
Indiciu

O adnotare de validare pentru lungimea textului, activată cu @Valid.

Alte forme ale mesajului

  • ERROR: value too long for type character varying(20)
  • Data too long for column 'nume' at row 1
  • Value too long for column "NUME CHARACTER VARYING(255)"

Cum o eviți pe viitor

  • Pune @Size(max = N) pe câmpurile text din DTO-uri și @Column(length = N) cu aceeași valoare în entitate.
  • Pentru texte libere lungi, folosește @Lob sau un tip text.
  • Tratează DataIntegrityViolationException ca 409/400 într-un @RestControllerAdvice, pentru ce scapă validării.
  • Testează cu valori la limită: exact N caractere și N + 1.

Întrebări frecvente

255 înseamnă caractere sau octeți?

În H2 și PostgreSQL, varchar(255) înseamnă caractere. În MySQL tot caractere, dar cu limite de octeți pe rând și pe index, care contează pentru diacritice și emoji în utf8mb4.

De ce nu se schimbă coloana când modific length?

Cu ddl-auto=update, Hibernate nu micșorează sau mărește coloanele existente. Schimbarea se face printr-o migrare (Flyway, Liquibase) sau recreând schema în dezvoltare.

Erori înrudite

← Toate erorile Spring Boot

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Spring Boot de la zero, cu exerciții la fiecare lecție

Curs Spring Boot și REST API: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 18 lecții sunt gratuite.