Para administradores
← Todos los temas

Solución de problemas

Síntoma, causa y qué hacer: desde un acceso al buzón que falta hasta un secreto caducado.

Primero, la visión general desde el directorio de la instalación:

./draften status      # versión, estado de los dos colores de la web y de los workers, HTTPS, volcados de la base de datos

Después, con más detalle:

docker compose ps                        # ¿están en marcha los servicios, está sana la base de datos?
docker compose logs --tail 50 worker     # las últimas entradas del worker
docker compose run --rm worker node diag.mjs mailbox@company.com

El último hace lo mismo que Probar la conexión en la interfaz: toma el acceso guardado para el buzón, obtiene un token, muestra sus permisos (nunca el token en sí) y lee la bandeja de entrada.

Errores frecuentes

SíntomaCausaQué hacer
set DB_PASSWORD in .env al iniciarfaltan las contraseñas de la base de datoscompletar .env
mailbox … has no access yetel buzón no tiene registro ni cuenta conectadala página del buzón › Acceso al correo
«La organización no tiene configurado ningún cliente de Microsoft 365 ni de Google» al conectar un buzón con la cuentala organización no tiene ningún cliente en la tarjeta Inicio de sesión con cuenta y conexión de buzoneslo añade un propietario de la organización: consulte Microsoft 365 o Google Workspace, cliente de la organización
Graph … 401 … invalid_clientclient secret incorrecto o caducadoun secreto nuevo en el registro y después la prueba de la conexión
Graph … 403 … AppOnly AccessPolicyla política de acceso de la aplicación aún no se ha aplicado, o el buzón no está en el grupoesperar (incluso horas) y repetir la prueba; añadir el buzón al grupo
Graph … 403 … ErrorAccessDeniedfalta el consentimiento del administradoren Entra, Grant admin consent en el registro
Category not added … MailboxSettingsfalta el permiso MailboxSettings.ReadWrite; la etiqueta funciona, solo que sin colorañadir el permiso y el consentimiento
No active assistant in the databaseel asistente está desactivado o no se cargaron los datos inicialesactivar el asistente; revisar los registros del arranque
el asistente se omite («no prompts yet»)el asistente no tiene instrucciones escritasterminar la configuración guiada o escribir las instrucciones a mano
la muestra de la configuración guiada indica pocos datosel propietario respondía antes desde otra dirección (por ejemplo, antes de un cambio de dominio) y la configuración guiada no cuenta esas respuestas como suyasañadir la dirección en el campo Otras direcciones del buzón (junto a la muestra, en el paso Período o en la página del buzón) y elegir de nuevo la muestra; la dirección completa, no solo el dominio
Draft without signature / links outside the allowed domainsel borrador no superó un controlmirar el mensaje: puede ser un intento de suplantación
Limit reachedel límite diario o el límite por remitenteaumentarlo solo si la avalancha de correo es legítima
Model refused to answerel filtro de seguridad del modeloprocesar el mensaje a mano
Model exhausted max_iterationsel modelo entró en un bucle con sus herramientasse reintenta dos veces; si se repite, ajustar la instrucción Tarea
ECONNREFUSED … 3306la base de datos no está en marcha o aún no ha arrancadodocker compose ps, docker compose logs db
la barra «La licencia caducó» o «La instalación no tiene licencia», los asistentes no escriben nadafalta la licencia o ha caducadosubir una licencia válida: vea La licencia
el servicio web deja de responder un momento y se pierden las peticiones en curso; en el registro del servicio web (docker compose logs web-blue web-green) hay un reiniciouna petición superó el límite estricto de memoria de PHP (desde PHP 8.5.12, el doble de memory_limit) y PHP terminó todo el proceso webDocker vuelve a iniciar el servicio web por sí solo, normalmente en unas decenas de segundos; si se repite, busque en el registro la petición que superó el límite
una actualización terminó con un errorla versión nueva no llegó a estar sana; la anterior sigue atendiendoel error en Historial de solicitudes o en la salida de ./draften update; ./draften status
el servicio web devuelve 502 tras reiniciar el servidorlas versiones anteriores al 30 de octubre de 2026 cambiaban el servicio web de forma que Docker daba el proxy por detenido a mano y, por eso, no lo volvía a arrancar al reiniciarse la máquinaen el directorio de la instalación, docker compose up -d --no-deps proxy; lo soluciona de forma definitiva actualizar a la versión del 30 de octubre de 2026 o posterior
«La última copia diaria ha fallado» en la tarjeta Copias de seguridad de la base de datosel volcado de la base de datos falló (el mensaje está en la tarjeta); se vuelve a intentar una hora despuésejecutar ./draften backup y leer el error; comprobar el espacio libre en disco (df -h) y ./draften status

Cuando los registros no lo muestran

Una pasada única a mano

docker compose run --rm worker node worker.mjs --dry-run

Recorre una vez cada asistente activo y fuerza el modo de prueba: no se escribe nada en el correo. Es útil para comprobar que todo funciona.

Cuando necesite nuestra ayuda

./draften diagnose

escribe un archivo diagnose-<time>.tar.gz con el estado de la instalación, las versiones, la configuración sin secretos y el final de los registros. Envíenoslo.

Antes de enviar el archivo, mire su contenido: los registros pueden contener direcciones y asuntos del correo procesado. Nada sale del servidor por sí solo.

Versión en texto