CF Pages env vars no aplican sin re-deploy

Cuándo

Mediados de marzo 2026. Se editaron variables de entorno desde el dashboard de Cloudflare Pages (Settings → Environment Variables) esperando efecto inmediato sobre la instancia en producción activa.

Síntomas

El sitio seguía leyendo valores anteriores. Llamadas a servicios externos fallaban con errores de autenticación porque las nuevas claves no se inyectaban. Ningún error visible en el dashboard de CF Pages; deployment activo marcado como “Success” sin indicación de variables desactualizadas.

Causa raíz

Cloudflare Pages inyecta variables de entorno en el momento del build y del deployment, no en runtime. Editar una variable desde el dashboard actualiza la configuración almacenada, pero el deployment activo ya fue compilado con los valores anteriores. Mientras no se dispare un nuevo deployment, Worker/Function sigue ejecutándose con el snapshot previo. Comportamiento no destacado con advertencia en la UI al guardar cambios.

Fix aplicado

Re-deploy manual desde el dashboard (opción “Retry deployment” sobre el último exitoso). Tras el nuevo deployment, variables actualizadas inyectadas correctamente.

Lecciones

Editar variables en CF Pages NO es equivalente a editar un .env con hot-reload. Cambio materializa en el próximo deployment.
UI de CF Pages no emite advertencia ni badge “pendiente de re-deploy” al guardar variables. Comportamiento silencioso y confuso.
No asumir que cambios de configuración en plataformas serverless tienen efecto inmediato.

Preventivos futuros

Documentar en runbook del proyecto: “todo cambio de env vars en CF Pages requiere re-deploy manual”.
Tras cualquier edición de variables, incluir en checklist de operaciones el paso explícito de disparar nuevo deployment.
Evaluar Cloudflare Workers KV o secrets externos (Doppler) para variables que cambien frecuentemente sin requerir re-deploy.

Véase también

[[decision—20260115—astro-cf-pages]]