Value too long for column "NUME CHARACTER VARYING(20)"
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
record ProdusNou(String nume) { }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
@Column(length = 20)
private String descriere;@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
@Size(max = 100) String nume // DTO
@Column(length = 50) String nume // entitate@Size(max = 50) String nume // DTO
@Column(length = 50) String nume // entitateDacă validarea permite mai mult decât coloana, textele dintre 51 și 100 de caractere ajung tot la eroarea din bază.
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.
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()));
}
}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.
Reparația
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(@Size(max = 20) 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(@Valid @RequestBody CategorieNoua c) {
return repo.save(new Categorie(c.nume()));
}
}De ce merge
În aplicația reală, numele de 33 de caractere ar fi trecut de controller și ar fi picat la insert cu Value too long for column, deci 500. Cu @Size(max = 20) și @Valid, cererea e oprită la intrare cu 400, iar limita din validare e aceeași cu @Column(length = 20). Laboratorul nu impune lungimea coloanei, dar regula de validare e exact cea pe care o scrii și în proiect.
Alte forme ale mesajului
ERROR: value too long for type character varying(20)Data too long for column 'nume' at row 1Value 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
@Lobsau un tiptext. - Tratează
DataIntegrityViolationExceptionca 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
NULL not allowed for column "NUME" Încerci să salvezi o entitate cu null într-o coloană declarată NOT NULL (de exemplu @Column(nullable = false)). Baza refuză inserarea și primești DataIntegrityViolationException, deci 500. Validează datele înainte (@NotBlank cu @Valid) sau setează valoarea lipsă. Unique index or primary key violation: "PUBLIC.UK_PRODUS_COD ON PUBLIC.PRODUS(COD)" Ai încercat să salvezi un rând cu o valoare care există deja într-o coloană unică (sau cu o cheie primară deja folosită). Baza de date refuză, iar Spring aruncă DataIntegrityViolationException, adică 500. Verifică înainte cu existsBy... și răspunde 409, sau tratează excepția. Î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.
