401 Unauthorized: jwt expired
Tokenul JWT a trecut de momentul de expirare (claim-ul exp), deci serverul nu-l mai acceptă. Fă din nou login (sau folosește refresh token-ul) și salvează tokenul nou; ca să nu se mai întâmple, reîmprospătează-l automat într-un pre-request al colecției.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un JWT conține în payload câmpul exp, momentul (în secunde Unix) după care nu mai e valid. Serverul compară exp cu ora lui și respinge tokenurile expirate cu 401. Mesajul exact diferă de la server la server: jwt expired (biblioteca jsonwebtoken din Node), token_expired, Token has expired; antetul WWW-Authenticate poate conține error="invalid_token", error_description="expired".
În Postman se întâmplă când tokenul salvat în environment a fost obținut acum o oră, iar durata lui e o oră. Totul mergea, apoi brusc toate cererile dau 401.
Reparația imediată: login din nou. Reparația de durată: salvezi la login și momentul expirării, iar un pre-request la nivel de colecție face login automat (cu pm.sendRequest) când tokenul lipsește sau expiră în curând.
De ce apare: cauzele frecvente
1Token vechi, salvat de ieri
Environment Dev: token = eyJ... (exp trecut)
GET {{baseUrl}}/auth/mePOST /auth/login → salvează tokenul nou
GET {{baseUrl}}/auth/meUn token nou are exp în viitor.
2Fără reîmprospătare automată
// nimic în pre-request-ul colecțieiif (Date.now() > Number(pm.environment.get("tokenExpira") || 0) - 30000) {
// pm.sendRequest spre /auth/login și salvează tokenul
}Scriptul obține un token nou înainte să expire cel vechi.
Repară eroarea, direct în pagină
Tokenul salvat în environment-ul Dev a expirat ieri, iar „Profil” răspunde 401 token_expired. Trimite „Login” (scriptul lui salvează tokenul nou în aceeași variabilă), apoi din nou „Profil”: trebuie să primești 200.
Indiciu
Un token expirat nu se repară; se înlocuiește.
Reparația
1. Trimite Login: pm.environment.set("token", pm.response.json().token) salvează tokenul nou. 2. Trimite Profil.
De ce merge
Tokenul vechi avea exp în trecut, deci serverul îl respingea. Tokenul obținut acum are exp peste o oră. Pasul următor e reîmprospătarea automată în pre-request-ul colecției, ca să nu mai depinzi de un login manual. Tokenurile JWT au un câmp exp, după care serverul le refuză. Un login nou produce un token proaspăt, valabil încă o perioadă, iar cererile protejate primesc din nou 200.
Alte forme ale mesajului
401 Unauthorized: token_expiredTokenExpiredError: jwt expired{"message": "Token has expired"}
Cum o eviți pe viitor
- Salvează la login și
tokenExpira(Date.now() + expiresIn * 1000). - Pune un pre-request la nivel de colecție care face login când tokenul expiră în mai puțin de 30 de secunde.
- În rulările lungi (Newman), reîmprospătarea automată e obligatorie.
Întrebări frecvente
Cum văd când expiră tokenul?
Decodează payload-ul (jwt.io sau atob pe a doua parte) și citește exp; e în secunde Unix.
E un bug dacă tokenul expiră?
Nu, e comportamentul dorit. Bug ar fi ca un token expirat să fie încă acceptat.
Erori înrudite
401 Unauthorized Serverul nu știe cine ești: tokenul lipsește, e expirat sau invalid, sau cheia API nu e trimisă. Obține un token nou (login) și verifică în Console că antetul Authorization chiar pleacă cu cererea. JsonWebTokenError: jwt malformed Ce ai trimis ca token nu are forma unui JWT (trei părți separate prin puncte): de obicei ai salvat tot răspunsul de la login în loc de câmpul token, ai copiat tokenul trunchiat sau variabila e goală. Salvează exact câmpul cu tokenul. JsonWebTokenError: invalid signature Tokenul are forma corectă, dar semnătura nu se potrivește cu cheia serverului: a fost emis de alt mediu (Staging în loc de Dev), cheia s-a schimbat sau cineva a modificat payload-ul. Obține un token nou chiar de la serverul pe care îl testezi. Învață Postman de la zero, cu exerciții la fiecare lecție
Curs API Testing cu Postman: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.
