Per gli amministratori
← Tutti gli argomenti

Risoluzione dei problemi

Sintomo, causa e cosa fare – dall’accesso alla casella mancante a un segreto scaduto.

Prima il quadro generale, dalla cartella dell’installazione:

./draften status      # versione, stato di entrambi i colori web e dei worker, HTTPS, dump del database

Poi più nel dettaglio:

docker compose ps                        # i servizi sono attivi, il database è in salute?
docker compose logs --tail 50 worker     # le ultime voci del worker
docker compose run --rm worker node diag.mjs mailbox@company.com

L’ultimo fa la stessa cosa di Testa la connessione nell’interfaccia: prende l’accesso salvato per la casella, ottiene un token, stampa le sue autorizzazioni (mai il token stesso) e legge la posta in arrivo.

Errori comuni

SintomoCausaCosa fare
set DB_PASSWORD in .env all’avviomancano le password del databasecompila .env
mailbox … has no access yetla casella non ha una registrazione né un account collegatopagina della casella → Accesso alla posta
“L’organizzazione non ha configurato un client Microsoft 365 o Google.” quando si collega una casella con l’accountl’organizzazione non ha un client nel riquadro Accesso con account e collegamento delle casellelo aggiunge un proprietario dell’organizzazione – vedi Microsoft 365 o Google Workspace, client dell’organizzazione
Graph … 401 … invalid_clientclient secret errato o scadutoun nuovo segreto nella registrazione, poi il test della connessione
Graph … 403 … AppOnly AccessPolicyla policy di accesso dell’applicazione non è ancora in vigore, oppure la casella non è nel gruppoaspetta (anche ore), ripeti il test; aggiungi la casella al gruppo
Graph … 403 … ErrorAccessDeniedmanca il consenso dell’amministratorein Entra, Grant admin consent nella registrazione
Category not added … MailboxSettingsmanca l’autorizzazione MailboxSettings.ReadWrite; l’etichetta funziona, solo senza coloreaggiungi l’autorizzazione e il consenso
No active assistant in the databasel’assistente è disattivato, oppure i dati iniziali non sono stati configuratiattiva l’assistente; controlla il log di avvio
l’assistente viene saltato (“no prompts yet”)l’assistente non ha istruzioni scrittecompleta la procedura guidata, oppure scrivi le istruzioni a mano
il campione nella procedura guidata segnala dati insufficientiil proprietario rispondeva prima da un altro indirizzo (per esempio prima di un cambio di dominio) e la procedura guidata non conta quelle risposte come sueaggiungi l’indirizzo nel campo Altri indirizzi della casella (accanto al campione, nel passaggio Periodo o nella pagina della casella) e scegli di nuovo il campione; l’indirizzo intero, non solo il dominio
Draft without signature / links outside the allowed domainsla bozza non ha superato un controlloguarda il messaggio – potrebbe essere un tentativo di falsificazione
Limit reachedil limite giornaliero o per mittenteaumentalo solo se l’ondata di posta è legittima
Model refused to answeril filtro di sicurezza del modellogestisci il messaggio a mano
Model exhausted max_iterationsil modello è finito in un ciclo con i suoi strumentiritentato due volte; se si ripete, metti a punto l’istruzione Compito
ECONNREFUSED … 3306il database non è attivo o non è ancora partitodocker compose ps, docker compose logs db
la barra “La licenza è scaduta” o “L’installazione non ha una licenza”, gli assistenti non scrivono nullala licenza manca o è scadutacarica una licenza valida – vedi La licenza
il servizio web per un attimo non risponde e le richieste in corso vanno perse; nel log del servizio web (docker compose logs web-blue web-green) c’è un riavviouna richiesta ha superato il limite rigido di memoria di PHP (da PHP 8.5.12 il doppio di memory_limit) e PHP ha terminato l’intero processo webDocker riavvia il servizio web da solo, di solito entro qualche decina di secondi; se si ripete, cerca nel log la richiesta che ha superato il limite
un aggiornamento è finito con un errorela nuova versione non è diventata sana; quella precedente continua a servirel’errore in Richieste o nell’output di ./draften update; ./draften status
il servizio web restituisce 502 dopo il riavvio del serverle versioni precedenti al 30 ottobre 2026 commutavano il servizio web in un modo per cui Docker considerava il proxy fermato a mano, e quindi non lo faceva ripartire al riavvio della macchinanella directory dell’installazione, docker compose up -d --no-deps proxy; lo risolve definitivamente l’aggiornamento alla versione del 30 ottobre 2026 o successiva
“L’ultimo backup giornaliero non è riuscito” nel riquadro Backup del databaseil dump del database non è riuscito (il messaggio è nel riquadro); si riprova un’ora dopoesegui ./draften backup e leggi l’errore; controlla lo spazio libero su disco (df -h) e ./draften status

Quando il log non lo mostra

Un passaggio singolo a mano

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

Prende una volta ogni assistente attivo e forza la modalità di prova – nella posta non viene scritto nulla. Utile per verificare che tutto funzioni.

Quando ti serve il nostro aiuto

./draften diagnose

scrive un file diagnose-<ora>.tar.gz con lo stato dell’installazione, le versioni, la configurazione senza segreti e la parte finale dei log. Inviacelo.

Prima di inviare il file, guarda cosa contiene: i log possono contenere indirizzi e oggetti della posta elaborata. Nulla lascia il server da solo.

Versione solo testo