L'error de dotenv que et farà perdre tota una tarda

¿L'teva app ignora els canvis a .env? Descobreix per què dotenv no sobrescriu variables i com solucionar-ho en segons. Estalvia hores de frustració.

domingo, 5 de julio de 2026 • 3 min de lectura • Equip Q2BSTUDIO

Com evitar que variables d'entorn velles arruïnin la teva app

En el desenvolupament de programari, la gestió de configuracions és un punt crític que sol generar confusions difícils de rastrejar. Un cas recurrent passa amb llibreries com dotenv, que per disseny no sobrescriuen variables d'entorn ja definides al sistema. Aquest comportament, tot i que correcte des del punt de vista de les bones pràctiques d'aplicacions de dotze factors, pot provocar errors en entorns de desenvolupament quan una variable obsoleta queda emmagatzemada al shell o en fitxers d'inici com .zshrc o .bashrc.

Imaginem un escenari típic: un equip treballa en aplicacions a mida que consumeixen serveis externs mitjançant claus API. En modificar el fitxer .env amb una nova clau vàlida, l'aplicació continua utilitzant l'antiga perquè el procés ha heretat una variable d'entorn del shell. Això genera fallades intermitents, com errors de quota o autenticació, que solen atribuir-se erròniament a la xarxa, al proveïdor del servei o fins i tot a la configuració del servidor. La clau està a entendre que dotenv prioritza les variables de l'entorn real sobre les del fitxer local, i que per forçar la lectura del .env en desenvolupament es necessita l'opció override: true.

A Q2BSTUDIO, en desenvolupar programari a mida per a empreses de diversos sectors, incorporem aquestes consideracions des de l'arquitectura. Per exemple, en integrar intel·ligència artificial o agents IA en processos de negoci, la correcta gestió de credencials és fonamental per evitar fuites d'informació o costos innecessaris. De la mateixa manera, en projectes de ciberseguretat i pentesting, controlar l'origen de cada variable d'entorn evita que configuracions incorrectes obrin escletxes de seguretat. El nostre equip també desplega solucions en serveis cloud aws i azure, on les variables d'entorn s'injecten des dels serveis gestionats, i és crucial que els desenvolupadors locals respectin aquesta jerarquia.

Per diagnosticar aquest problema, n'hi ha prou amb imprimir el final de la variable que l'aplicació està utilitzant realment. Si no coincideix amb l'esperat, cal buscar l'origen del valor obsolet: pot estar en un export als fitxers de perfil, en un docker run -e o en un secret de CI. La solució més directa per a desenvolupament és activar override: true a la crida a dotenv, però també es pot optar per netejar el shell manualment si es prefereix mantenir el comportament per defecte en producció.

Més enllà de les claus API, aquesta mateixa dinàmica afecta configuracions de bases de dades, endpoints de serveis intel·ligència de negoci o connexions a eines com Power BI. Per això, recomanem als nostres clients que, en desenvolupar aplicacions a mida, estableixin una estratègia de configuració des de l'inici, diferenciant entre entorns i documentant les dependències. Si necessites suport en la creació d'ia per a empreses o en l'automatització de fluxos, a Q2BSTUDIO integrem aquestes pràctiques per garantir desplegaments fiables i eficients.

En resum, quan una variable d'entorn es resisteixi a canviar, no perdis la tarda mirant factures o logs del proveïdor. Comprova quin valor està llegint el teu procés aplicatiu. Una línia de depuració pot estalviar-te hores. I si el teu equip necessita reforçar els seus processos de desenvolupament o migrar a una arquitectura més robusta, el nostre servei de programari a mida està dissenyat per evitar aquest tipus de maldecaps.

UNA PAUSA?

Juga una estona abans de marxar

ELS NOSTRES SERVEIS

Com et podem ajudar

Tens un projecte en ment?

Explica'ns la teva visió i la convertim en una solució de programari. Sigui quin sigui l'abast, fem realitat la teva idea.