O bug que custa uma semana vive em um telefone que ninguém da equipe segurou. No Sudeste Asiático em 2025, 89% dos smartphones enviados custavam menos de 200 dólares — dispositivos com 2 a 4 GB de RAM e um motor WebView alguns Chromium atrás. O iPhone 15 sobre a mesa não reproduz nada. Um mini-program roda dentro de um app host que não pode ser instrumentado e em uma rede que não pode ser vigiada, então o loop de debugging confortável — reproduz localmente, conserta, envia — não se aplica. A única testemunha é o dispositivo, e a equipe tem de ir até ele.
Debugging remoto em hardware real é mais falho em entrada
O debugging remoto do Chrome via ADB roda em Android real, mas os dispositivos de entrada são exatamente onde é menos estável: o debug USB cai, o debug sem fio adiciona latência que esconde a corrida, e um telefone a 2% de bateria faz throttle, arrastando a curva de CPU que se observa junto. A disciplina que sobrevive a isso é tratar o dispositivo como fonte de verdade desde o dia um, não recorrer a ele só depois que o emulador falha. Uma equipe mantém uma unidade de cada modelo de entrada principal no estoque e roda regressão em dispositivo real no CI, em vez de derivar nos emuladores.
Os source maps somem após o release
A segunda armadilha é o stack. Localmente o crash é app.js linha 120; depois que o host ou o minificador do host toca, o stack retornado está minificado e as linhas não batem. Sem upload de source map e symbolication, um erro de produção é uma bagunça irlocalizável. A prática correta é enviar source maps a um servidor de símbolos em tempo de build e restaurá-los automaticamente às linhas de origem no relatório de crash. Caso contrário "uma pilha de erros de produção, nada reproduzível localmente" continua drenando a paciência de toda a equipe.
| Método | Desktop | Entrada real | Produção |
|---|---|---|---|
| Breakpoint remoto | Suave | Falho, cai | Nenhum |
| Stack de crash | Linha de origem | Linha de origem | Precisa de source map |
| Reproduzir | Fácil | Difícil | Via upload do usuário |
Observabilidade: deixe o dispositivo falar
O que realmente captura o resto é coletar crashes, gagueira e falhas de rede no cliente e enviá-los ao servidor, em vez de esperar um ticket de suporte. Uma equipe, via relatório remoto de crash, encontrou uma API específica que dava crash duro no WebView 94 em um modelo particular — algo que nenhum dispositivo de teste deles mostrou. Sem essa camada de relatório, o bug teria ficado arquivado como "problema de rede de um usuário".
A camada de rede também tem de ser visível
Crashes são apenas metade da verdade. A outra metade é rede: qual host, qual tipo de rede, mostra um pico de timeouts ou falhas para um endpoint. Uma equipe descobriu via relatório de cliente que o CDN da equipe de assets silenciosamente descartava arquivos grandes sob a configuração de MTU de uma operadora — algo que o ambiente de teste WiFi jamais reproduziu. Coletar falhas de rede por host, tipo de rede e dimensão de endpoint faz o dispositivo de fato testemunhar; caso contrário "problema de rede de um usuário" segue tomando a culpa.
Amostragem de log, não um firehose
O armazenamento e o upload em entrada são preciosos; logging completo se volta contra o time arrastando desempenho e comendo dados de usuário. A prática que segura é a amostragem: manter apenas marcadores leves em caminhos críticos diariamente, e anexar um ring buffer recente no crash ou anomalia. Uma equipe trocou de completo para "amostrado mais anexado a crash" e viu as queixas de desempenho em entrada caírem sem perder nenhum bug real. O objetivo da observabilidade não é encher o dispositivo de logs, mas deixar o dispositivo inalcançável explicar o que aconteceu quando importa.
A taxa livre-de-crash é a única métrica que viaja
Crashes, gagueira e eventos de rede falhados devem se consolidar em uma única porcentagem livre-de-crash, fatiada por host e modelo de dispositivo, com um limiar de alerta que aciona alguém quando cai. As equipes que sobrevivem ao caos de entrada são as que vigiam esse número diariamente por toda a frota, não as que esperam uma revisão mencionar um crash. Uma equipe definiu uma meta de 99,5% livre-de-crash e capturou uma falha específica de WebView 94 em horas após um release porque o consolidado sinalizou o modelo, em vez de deixá-la esconder em uma queixa que ninguém leu.
O resumo
No debugging de mini-program, a fonte de verdade nunca foi o laptop, mas o dispositivo fora de alcance. Estabeleça debugging remoto, source maps e observabilidade de cliente desde o dia um, e o dispositivo testemunha pela equipe.