Solución de problemas
Primero: activar el log de errores
La aplicación oculta los errores en producción (errores = false). Antes de diagnosticar, confirme que PHP registra errores (log_errors = On) y revise ese log. Para ver los errores en pantalla, solo en un ambiente de pruebas, cambie AMBIENTE a un valor distinto de 'PRD'.
Postulantes
| Síntoma | Causas probables | Qué revisar |
|---|---|---|
| "Crear Cuenta" dice que el periodo no está activo, no inicia o ya cerró | No hay periodo activo o la fecha está fuera de la ventana de postulación | periodos: activo = 1 y fechas de postulación |
| Después de registrarse aparece una página en blanco | Salida antes de una redirección (BOM en un PHP) con output_buffering desactivado |
Ejecutar la búsqueda de BOM (ver Requisitos y despliegue); output_buffering = 4096 |
| No llega el correo de activación | Spam; correo mal escrito; MTA caído; NOTIFICAR = false |
Registro en postulantes; log del MTA; activar a mano (ver Tareas frecuentes) |
| El enlace de activación "no existe" o "expiró" | Pasaron más de 24 horas, ya se usó, o el periodo cambió | postulantes.estado, key_tstamp, periodo |
| "Usuario o Clave Incorrecta" con la clave correcta | Cuenta no activada (estado ≠ 1); cuenta de otro periodo; RUT con otro formato |
Las tres condiciones: periodo activo, fila del periodo activo, estado = 1 |
| Ingresa los datos y vuelve al formulario de ingreso sin mensaje | La redirección después del ingreso no ocurre (BOM / salida previa) | Igual que la página en blanco |
| Con Pasaporte UChile lo envía a "actualizar cuenta" | La persona no existe en U-Campus ni como postulante | Es el comportamiento esperado: debe completar sus datos |
| Error al ingresar con Pasaporte UChile | Falla CAS, el servicio de atributos o U-Campus | Conectividad a sso.uchile.cl, URL_CAS y ucampus.uchile.cl; certificado CACert.pem |
| No aparece "Nueva Postulación" | Ya envió su postulación, o la ventana de postulación está cerrada | Estado de la postulación; fechas del periodo |
| No puede subir un documento | Extensión no permitida o archivo mayor a 10 MB; permisos de la carpeta de documentos | upload_max_filesize, post_max_size; permisos de /var/upload/... |
| No aparece "Rendir Examen" | No fue notificado (estado distinto de 70 u 80–170) | Estado de la postulación; pantalla Notificar del examen |
| El examen dice "ya terminaron los minutos" | El tiempo empezó al iniciar y no se detiene | examen_*_inscripciones.fecha_inicio, fecha_termino |
Funcionarios
| Síntoma | Causas probables | Qué revisar |
|---|---|---|
| No ve una opción del menú | Su perfil no tiene el permiso | Administrador → Perfiles; ver Permisos y perfiles |
| Decidió postulaciones pero el postulante no recibió nada | No presionó Procesar | Consulta de marcas pendientes en Tareas frecuentes |
| "TIENE EXÁMENES NO CREADOS" al asignar | Falta el examen de alguna disciplina | Exámenes → Mantenedor Examen |
| Los correos de examen no llegan a nadie | Ningún postulante marcado para notificar; MTA | Pestaña "Pendientes de Notificar"; log del MTA |
| El Excel de exportación falla | Faltan dependencias de Composer o extensiones zip/xml/gd |
composer install; php -m |
Solicitudes de la Escuela
| Síntoma | Causas probables | Qué revisar |
|---|---|---|
| El estudiante no puede ingresar | U-Campus o el servicio de atributos no responden; el estudiante no tiene carrera activa | Conectividad; respuesta de U-Campus |
| Un funcionario entra como estudiante | Su usuario no existe o está inactivo en la tabla usuario |
Usuario en la base solicitudes |
| No llegan los correos de solicitudes o resoluciones | El proceso periódico notificaciones.php no se está ejecutando |
Cron o tarea programada; estado de notificación de la solicitud |
Comandos útiles
# Archivos PHP con BOM (no debe listar nada)
grep -rlI $'^\xEF\xBB\xBF' --include=*.php /var/www/html/pregrado/
# Versión y extensiones de PHP
php -v && php -m | grep -Ei 'pdo_mysql|mbstring|curl|zip|gd|xml'
# Revisar la sintaxis de un archivo
php -l /var/www/html/pregrado/admision_post/externo.php
# Probar el servidor de correo local
echo "prueba" | mail -s "prueba PEMACH" usuario@uchile.cl