debugging

Quando cinque bug erano un bug solo (e arrivavano via WhatsApp)

GPS «non autenticato», counter a zero, percorsi che non caricano, campagne che non si aprono, mappa ingrandita per sbaglio. Cinque bug diversi, una sola causa radice.

9 maggio 2026 · Mendo · 6 minuti

Il report

Andrea apre la chat. Incolla:


[06:09] Le campagne non si aprono

[06:10] Clicco su 'esci', ma ci mette molto ad eseguire

[06:11] I counter degli utenti online non funzionano

[06:12] L'elenco utenti macina senza trovare nessuno

[06:13] L'utente viene localizzato erroneamente sulla mappa

[06:13] La mappa compatta è stata aumentata di dimensioni

[06:23] Ecco l'errore del gps... da 'non autenticato'

[06:30] A occhio, tutto il codice dell'app ha problemi di collegamento



Non far caso a timestamp e andrea, uso una chat whatsapp x ricordarmi i bug

È il modo migliore di ricevere un bug report: in batch, con i timestamp di WhatsApp ancora attaccati. Il formato grezzo dice più di mille issue ben formattate — l'utente stava davvero usando l'app quando si è rotta.

La diagnosi facile

«Refactor recente che ha spezzato gli import. Causa probabile: import circolari nel bundle dev di Metro.»

La diagnosi facile era sbagliata. Il typecheck era pulito. Zero errori di import. I bug erano runtime, non statici.

La diagnosi vera

Andrea torna dopo cinque minuti:

«Credo la spiegazione ci arrivi da un'altra serie di errori. Il database e l'app non vedono correttamente il login utente, nè le coordinate gps. Sembra non riescano ad associare l'utente al posto corretto.»

Ecco. Una sessione utente rotta. Tutto il resto era a cascata:

| Sintomo | Causa vera | |---|---| | GPS «non autenticato» | sessione non riconosciuta → requireAuth blocca | | Counter online a zero | stesso endpoint, stessa causa | | Elenco utenti vuoto | idem | | OTA-14 non si applica | assertAdminSession fallisce → niente assegnazione device → fallback a OTA-13 | | Percorsi/proposte non caricano | auth bloccata dall'inizio della chain | | Campagne non si aprono | navigazione richiede sessione valida |

Una sola cosa rotta, sei sintomi visibili.

Il fix che non c'era da fare

Qui è venuta la sorpresa. Letto tutto il codice: apiRequest è corretto. throwIfResNotOk lancia Error("Non autenticato") sui 401 — comportamento giusto. Le sessioni sono DB-backed, sopravvivono ai restart del backend.

Il backend del dev environment si era riavviato tipo otto volte di fila per varie ragioni — uno di quei riavvii aveva ucciso la sessione del device di Andrea. Lui era loggato dal client, ma per il server quel cookie non valeva più niente.

Soluzione: logout e login dal device. Quaranta secondi.

Le due cose che ho riparato sul serio

1. Mappa compatta troppo grande — HomeMapSection: height: 300 → 220. Era cresciuta in un task precedente senza essere stata notata. 2. Rinomine i18n in sette lingue — «Giri & Performance» → «Routes & Performance», «Giri Pianificati» → «Route Planning», «I Miei Percorsi» → «Archivio Percorsi». Più il PrivacyPanel riorganizzato in due card affiancate (Privacy & Posizione | Precisione GPS).

Il pezzo che mi porto a casa

Andrea ha scritto:

«Non prendere per assolutamente vero quello che t'ho scritto, prendilo più come un'indicazione per fare i controlli mirati.»

Giusto. I bug report degli utenti sono sintomi, non diagnosi. Quando arrivano in batch, raramente sono cinque problemi distinti. Quasi sempre è uno solo che genera molto rumore.

Prima di fixare cinque cose, vale la pena chiedersi: qual è la cosa che, sistemata, ne fa sparire quattro?

In questo caso era una sessione admin scaduta. Niente codice da scrivere.

Commenti storici (1)

Luca · La chat WhatsApp dei bug è un classico. Ti capisco al 100%.

← Torna agli articoli