Un script funciona desde la terminal y falla cuando lo ejecuta cron. ¿Cómo comprobar rutas, entorno, versión de PHP y ejecuciones simultáneas?

Cron ejecuta un comando en un contexto distinto de tu terminal interactiva. Puede cambiar el directorio inicial, el entorno y el ejecutable encontrado. Empieza por guardar el comando exacto y la programación actual; después prueba con el mismo usuario que ejecutará la tarea. No uses privilegios adicionales solo para ocultar un error de permisos.

1. Utiliza rutas absolutas para el intérprete y para el script. Si el programa espera archivos relativos, configura explícitamente su directorio de trabajo o ajusta sus rutas. En PHP comprueba la versión y el archivo de configuración del ejecutable CLI; no asumas que coincide con el PHP del dominio.

2. Redirige temporalmente la salida estándar y los errores a un registro privado que puedas consultar. Usa un nombre y una ubicación fuera de la raíz pública, con espacio disponible y permisos adecuados. Registra inicio, fin y código de salida. Evita enviar contraseñas como argumentos o volcarlas en el registro.

3. Revisa la frecuencia y la duración. La documentación de Cron Jobs recomienda dejar tiempo suficiente entre ejecuciones para evitar que una comience antes de terminar la anterior. Si el trabajo puede tardar de forma variable, utiliza el mecanismo de exclusión o bloqueo que admita tu aplicación y prueba su comportamiento.

Comprueba también la zona horaria utilizada para interpretar el horario y los permisos para leer configuración, escribir resultados y conectar con servicios externos. Una ejecución manual satisfactoria no valida todavía su horario automático.

Cuando hayas localizado la causa, realiza una prueba programada y confirma un único resultado completo. Retira la captura detallada de depuración y conserva un registro breve con rotación. Si no puedes observar la ejecución desde tu cuenta, comparte comando sin secretos, horario, hora esperada y error; esos datos permiten revisar la configuración sin adivinar.

Fuentes: cPanel — Cron Jobs · PHP — Command line usage.