db

Failed to load config

Antes de funcionar, tu app intenta cargar sus ajustes: a qué servicios se conecta, con qué claves, con qué opciones. Ese paso ha fallado, así que se para antes de empezar. El mensaje no dice cuál de todas las configuraciones es, y ahí está el trabajo.

Revisado en agosto de 2026

De paso

Ya de paso: ¿tu app está exponiendo datos?

Analízala gratis mientras lees. Tarda treinta segundos y no toca nada.

Solo leemos lo que tu app ya le entrega a cualquier visitante.

Diagnóstico

Por qué te pasa

La causa más común es que la configuración se construya a partir de variables de entorno y alguna llegue vacía en producción. La app intenta armar sus ajustes, se encuentra un hueco donde esperaba un valor, y aborta. Es la misma familia de problemas que los errores de variables que faltan, solo que con otro nombre.

La segunda es que la configuración viva en un fichero que no ha llegado al despliegue, o que esté referenciado con un nombre que no coincide exactamente en mayúsculas. Tu ordenador no distingue mayúsculas y el servidor sí, así que un fichero llamado Config.json referenciado como config.json funciona en local y desaparece al publicar.

La tercera es que tu app pida su configuración a un servicio externo al arrancar y esa petición falle: porque el servicio está caído, porque la dirección está mal, o porque responde algo que no es lo que se esperaba. Si tu app carga ajustes desde una tabla de Supabase, un problema de permisos también produce este error.

Lo que este error no significa

  • No significa que hayas perdido la configuración. Los valores están donde los pusiste; lo que falla es que la app no los encuentra desde donde está corriendo.
  • No significa que el despliegue haya fallado. Si ves este mensaje es que la app se ha publicado y ha llegado a ejecutarse.
  • No se arregla escribiendo los valores directamente en el código. Es la tentación del momento y publica cualquier secreto que hubiera dentro.

Solución

Arréglalo tú, gratis

Como el mensaje es genérico, lo primero es conseguir el error de debajo. Con él, el arreglo suele ser de un minuto.

  1. 01Abre la app publicada, pulsa F12 y mira la pestaña Console. Muchas veces, justo antes o después de este mensaje, aparece el error real diciendo qué faltaba.
  2. 02Mira también la pestaña Network. Si tu app pide la configuración a algún sitio, verás esa petición y su resultado. Un 401 o un 403 ahí significa que el problema es de permisos, no de configuración.
  3. 03Si el error menciona una variable, ve al panel de tu hosting, compruébala y da de alta la que falte marcando todos los entornos. Después vuelve a desplegar, porque las variables se leen al construir.
  4. 04Si menciona un fichero, comprueba que el nombre coincide letra por letra, mayúsculas incluidas, con el fichero real del proyecto.
  5. 05Si la petición de configuración va a una tabla de tu base de datos, revisa que esa tabla tenga una política de lectura que permita leerla en el momento en que tu app la pide, que suele ser antes de que el usuario haya iniciado sesión.

Y esto para la parte de código

Pégaselo tal cual al agente que escribió tu app. Está redactado para que te diga lo que ha hecho, no solo para que lo haga.

Prompt para tu agente

Mi app da el error "Failed to load config" al arrancar en producción.

Necesito que hagas esto:
1. Busca en el proyecto qué código carga la configuración al arrancar y enséñamelo: de dónde saca cada valor, si de variables de entorno, de un fichero o de una petición.
2. Dime cuáles de esos valores pueden faltar o llegar vacíos en producción y qué pasa en cada caso.
3. Cambia el mensaje de error para que diga qué parte concreta de la configuración ha fallado y por qué, en vez del mensaje genérico. Sin ese detalle no hay forma de arreglarlo.
4. Si la configuración se pide a un servicio externo, añade manejo de error y un tiempo máximo de espera, para que un servicio lento no deje la app colgada indefinidamente.
5. Comprueba que ningún valor de configuración sensible se está escribiendo directamente en el código.

Si no sale

¿Lo has intentado y sigue sin salir?

O el escáner de arriba ha encontrado algo y prefieres no tocarlo solo. En cualquiera de los dos casos esto ya es de los gordos y merece un humano: no es que no hayas sabido, es que has llegado al punto en que hace falta alguien que entre y lo vea por dentro.

Las 10 primeras apps son gratis. Estoy empezando y necesito casos reales. A cambio te pido permiso para contar después qué me encontré, sin decir de quién era la app ni enseñar tus datos. Sin tarjeta y sin suscripción: cuando se acaben las plazas empezaré a cobrar y lo diré aquí.

Cita a partir de mañana

Agendar revisión

Gratis

durante el lanzamiento

Elegimos hueco, miro tu app con calma y te digo qué pasa y cómo se arregla.

  • Sesión de trabajo en directo contigo
  • Diagnóstico del error y del riesgo real
  • Te quedas con el arreglo aplicado

Hoy, en cola prioritaria

Rescate exprés

Gratis

durante el lanzamiento

Entras en la cola de hoy. Reservas hueco y lo dejamos resuelto en el día.

  • Hueco el mismo día
  • Prioridad sobre las revisiones agendadas
  • Mismo trabajo, antes

Quién

Marc Sala

IT Manager

  • Analista de ciberseguridad certificado por Google

No es un rating anónimo de un marketplace: es la persona que va a entrar en tu app. Reviso el código, encuentro qué falla y lo arreglo contigo delante, explicándote qué ha pasado sin jerga.