...
Eroare ASP.NET Core · Controllere, validare și ProblemDetails

The field CodPostal must match the regular expression '^\d{5}$'.

Pe scurt

Valoarea nu se potrivește cu expresia regulată din [RegularExpression]. Mesajul îți arată chiar regex-ul: verifică dacă datele sunt greșite sau dacă regula nu descrie formatul real (de exemplu codurile poștale din România au 6 cifre, nu 5).

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

Ce înseamnă

[RegularExpression("^\d{5}$")] acceptă doar valorile care se potrivesc în întregime cu expresia (atributul o tratează ca și cum ar avea ^...$, chiar dacă nu le scrii). Mesajul implicit include expresia, ceea ce te ajută la depanare, dar nu e potrivit pentru utilizatori.

Când o valoare care pare corectă e respinsă, de obicei regex-ul e prea strict: format din altă țară (cod poștal de 5 cifre în loc de 6), spații sau liniuțe nepermise, litere mici neacceptate. Testează expresia pe câteva valori reale înainte s-o pui în model.

Ca la celelalte atribute de format, null e acceptat (câmp lipsă); pentru obligatoriu combină cu [Required]. Mesajul se schimbă cu ErrorMessage.

De ce apare: cauzele frecvente

1Regex scris pentru alt format

Greșit
C#
[RegularExpression(@"^\d{5}$")] public string CodPostal { get; set; } = "";
// România: 6 cifre, de exemplu 010011
Corect
C#
[RegularExpression(@"^\d{6}$", ErrorMessage = "Codul poștal are 6 cifre.")]
public string CodPostal { get; set; } = "";

Expresia trebuie să descrie formatul real al datelor, iar mesajul să fie înțeles de utilizator.

2Spații sau litere mici neacceptate

Greșit
C#
[RegularExpression("^[A-Z]{2}[0-9]{2}[A-Z]{3}$")] public string Numar { get; set; } = "";
// trimis: "b 12 abc"
Corect
C#
// normalizează în client: "B12ABC" (fără spații, majuscule)

Fie normalizezi datele înainte de trimitere, fie extinzi expresia să accepte variantele.

Repară tu

Repară eroarea, direct în pagină

Adresele de livrare din România sunt respinse cu The field CodPostal must match the regular expression '^\d{5}$'., pentru că expresia cere 5 cifre. Schimbă regula la 6 cifre, cu mesajul Codul poștal are 6 cifre., ca 010011 să fie acceptat, iar 1234 respins.

Codul care dă eroarea
C#
using System.ComponentModel.DataAnnotations;
using Microsoft.AspNetCore.Mvc;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllers();
var app = builder.Build();
app.MapControllers();
app.Run();

public class AdresaLivrare
{
    public string Oras { get; set; } = "";
    // TODO: codurile poștale din România au 6 cifre
    [RegularExpression(@"^\d{5}$")] public string CodPostal { get; set; } = "";
}

[ApiController]
[Route("api/adrese")]
public class AdreseController : ControllerBase
{
    [HttpPost]
    public IActionResult Salveaza(AdresaLivrare a) => Ok($"Livrare în {a.Oras}, cod {a.CodPostal}");
}
După reparație, programul afișează
POST /api/adrese → 200 OK
Livrare în București, cod 010011
POST /api/adrese → 400 Bad Request
{"type":"https://tools.ietf.org/html/rfc9110#section-15.5.1","title":"One or more validation errors occurred.","status":400,"errors":{"CodPostal":["Codul poștal are 6 cifre."]}}
Indiciu

[RegularExpression(@"^\d{6}$", ErrorMessage = "...")].

Alte forme ale mesajului

  • The field Cod must match the regular expression '^[A-Z]{3}$'.

Cum o eviți pe viitor

  • Testează expresia pe valori reale (inclusiv margini) înainte să o folosești.
  • Folosește ErrorMessage cu o explicație pe înțeles, nu regex-ul.
  • Normalizează datele (spații, majuscule) înainte de validare, când e posibil.
  • Pentru formate complexe, preferă un atribut propriu cu cod clar.

Întrebări frecvente

Trebuie să scriu ^ și $?

Nu e obligatoriu: atributul verifică oricum potrivirea întregii valori. Le poți scrie pentru claritate.

De ce în mesaj apar două backslash-uri?

În JSON, backslash-ul e escapat, deci \d apare ca \\d. Expresia reală are un singur backslash.

Erori înrudite

← Toate erorile ASP.NET Core

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ță ASP.NET Core de la zero, cu exerciții la fiecare lecție

Curs ASP.NET Core: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 20 lecții sunt gratuite.