Aller au contenu

Exemples de rapport de bug : bons et mauvais, comparés

Quatre exemples réalistes de rapport de bug, chacun en version faible puis réécrite, avec ce qui rend un rapport de bug facile à traiter.

Un bon exemple de rapport de bug a toujours les mêmes éléments : un titre précis, l’environnement, des étapes de reproduction numérotées partant d’un point de départ connu, le résultat attendu et le résultat obtenu avec le texte exact des erreurs, la fréquence, et des preuves. Voici quatre bugs réalistes, chacun écrit deux fois : d’abord comme les bugs sont souvent signalés, puis réécrit de façon qu’un développeur puisse agir sans poser une seule question.

Les exemples couvrent les types de bugs les plus courants : un parcours qui échoue sans rien dire, un problème d’affichage sur un seul appareil, des données fausses et une erreur intermittente. Si vous voulez une version vierge du format, copiez notre modèle de rapport de bug. Pour comprendre à quoi sert chaque champ, lisez comment rédiger un rapport de bug.

Exemple 1 : un parcours qui échoue sans rien dire

Un utilisateur réinitialise son mot de passe, mais l’e-mail n’arrive jamais.

La version faible

Titre : Réinitialisation du mot de passe cassée

La réinitialisation du mot de passe ne marche pas. Essayé plusieurs fois. Merci de corriger au plus vite.

Ce rapport ne donne presque rien au développeur. Quel compte ? Quel environnement ? Le formulaire a-t-il affiché une erreur, ou a-t-il annoncé un succès ? « Essayé plusieurs fois » laisse entendre quelque chose, sans dire quoi. Et « au plus vite » sans mesure de l’impact n’aide personne à fixer les priorités.

La version solide

Titre : E-mail de réinitialisation non envoyé pour les comptes créés via la connexion Google

Environnement
- URL : https://app.example.com/forgot-password
- Chrome 154, macOS 26
- Compte : [email protected] (créé via « Continuer avec Google »)
- Heure : 2026-11-10 09:12 UTC

Étapes de reproduction
1. Aller sur /forgot-password en étant déconnecté.
2. Saisir [email protected] et cliquer sur « Envoyer le lien de réinitialisation ».

Résultat attendu
Un e-mail de réinitialisation arrive en quelques minutes.

Résultat obtenu
La page affiche « Consultez votre boîte de réception ». Aucun e-mail n’arrive
(attendu 30 minutes, spams vérifiés). Réseau : POST /api/auth/reset a renvoyé 200
avec le corps {"sent": false, "reason": "no_password_identity"}.

Fréquence
Toujours pour les comptes créés via Google (3/3). Fonctionne pour un compte
e-mail/mot de passe ([email protected]).

Gravité
Majeure : les utilisateurs inscrits via Google ne peuvent pas définir de mot de passe.

Pourquoi ça marche

La personne a comparé deux types de comptes et trouvé le point commun : seuls les comptes créés via la connexion Google sont touchés. Cette seule comparaison fait passer la cause de « l’e-mail est cassé » à une branche précise du code. Elle a aussi ouvert le panneau Network et copié le corps de la réponse, qui montre que le serveur sait qu’il n’a rien envoyé alors que la page annonce un succès. Ce décalage est un second bug qui mérite d’être signalé. L’heure exacte permet à l’équipe de consulter les logs du fournisseur d’e-mails. Si vous n’avez jamais regardé de requêtes réseau, notre guide pour capturer le trafic réseau dans Chrome vous montre comment faire.

Exemple 2 : un bug d’affichage sur un seul appareil

Sur un petit écran de téléphone, une bannière cache le bouton sur lequel les utilisateurs doivent appuyer.

La version faible

Titre : Impossible de cliquer sur enregistrer sur mobile

Le bouton enregistrer ne marche pas sur mon téléphone.

« Ne marche pas » peut vouloir dire que le bouton ne fait rien, qu’il affiche une erreur ou qu’on ne peut pas l’atteindre. « Mon téléphone » peut désigner des milliers d’appareils et de navigateurs. Un développeur qui teste sur un grand téléphone ne verra probablement aucun problème et fermera le ticket.

La version solide

Titre : La bannière cookies cache le bouton Enregistrer de la page profil sur petits écrans

Environnement
- URL : https://app.example.com/settings/profile
- Safari sur iPhone SE (3e génération), iOS 26, portrait
- Viewport d’environ 375 x 667
- Non reproductible sur iPhone 15 Pro ni sur ordinateur

Étapes de reproduction
1. Ouvrir l’URL dans un onglet privé (pour que la bannière cookies s’affiche).
2. Se connecter en tant que [email protected].
3. Faire défiler jusqu’en bas du formulaire de profil.

Résultat attendu
Le bouton Enregistrer est visible et utilisable au-dessus de la bannière cookies.

Résultat obtenu
La bannière cookies (fixe, environ 180 px de haut) cache le bouton Enregistrer.
Toucher l’emplacement du bouton ouvre le lien « Paramètres » de la bannière.
Fermer la bannière rend Enregistrer accessible.

Contournement
Accepter ou fermer d’abord la bannière cookies.

Pièces jointes
- Capture d’écran : profile-save-hidden-iphone-se.png (bannière entourée en rouge)

Pourquoi ça marche

Les bugs d’affichage dépendent de la taille de l’écran : l’appareil exact, l’orientation et le viewport sont les faits essentiels. La personne a aussi testé sur d’autres appareils et noté où le bug ne se produit pas, ce qui oriente le développeur vers les styles pour petits écrans. L’étape de l’onglet privé garantit que la bannière apparaît, pour que le développeur voie le même écran. Le contournement indique au support quoi dire aux utilisateurs dès aujourd’hui, et réduit l’urgence d’une manière que l’équipe peut évaluer elle-même.

Exemple 3 : des données fausses

Le total du tableau de bord ne correspond pas aux chiffres exportés.

La version faible

Titre : Les chiffres sont faux

Le chiffre d’affaires du tableau de bord est faux. L’export affiche autre chose.
Je ne sais pas lequel est juste, mais l’un des deux est cassé.

La personne a remarqué un vrai problème, mais « les chiffres sont faux » oblige le développeur à chercher quels chiffres, pour quelle période et de combien. Les bugs de données demandent des valeurs exactes, car l’ampleur de l’écart est souvent l’indice.

La version solide

Titre : Le chiffre d’affaires d’octobre du tableau de bord est inférieur de 1 240 $ à l’export CSV

Environnement
- URL : https://app.example.com/reports/revenue?period=2026-10
- Espace de travail : Acme Demo (ID 4821), fuseau horaire America/Los_Angeles
- Chrome 154, Windows 11

Étapes de reproduction
1. Ouvrir Rapports, puis Chiffre d’affaires.
2. Sélectionner octobre 2026.
3. Noter le total affiché sur la carte.
4. Cliquer sur « Exporter en CSV » et additionner la colonne Montant.

Résultat attendu
Le total du tableau de bord et la somme du CSV correspondent.

Résultat obtenu
Tableau de bord : 48 310,00 $. Somme du CSV : 49 550,00 $. Écart : 1 240,00 $.
L’écart correspond aux trois commandes passées le 31 octobre après 17 h,
heure de Los Angeles (ID 99812, 99815, 99820).

Fréquence
Toujours pour octobre. Les totaux de septembre correspondent.

Notes (hypothèse)
On dirait que le tableau de bord regroupe par date UTC et l’export
selon le fuseau horaire de l’espace de travail.

Pourquoi ça marche

Le rapport donne les deux chiffres, l’écart et les commandes qui le composent. Cette dernière étape a pris quelques minutes à la personne, et elle en fait gagner bien plus au développeur. L’hypothèse sur les fuseaux horaires est clairement présentée comme une hypothèse, séparée des observations. Préciser que septembre correspond montre que le bug est lié à des données précises, pas à tout le rapport.

Exemple 4 : une erreur intermittente

Les téléversements échouent parfois, et personne ne sait dire pourquoi.

La version faible

Titre : Le téléversement échoue parfois

Parfois les téléversements échouent avec une erreur. Ça arrive au hasard.

« Au hasard » veut généralement dire « pour une raison que personne n’a encore trouvée ». Sans le texte de l’erreur, les détails du fichier ou un décompte, il n’y a rien sur quoi enquêter.

La version solide

Titre : Le téléversement de fichiers de plus de 10 Mo échoue avec « Upload failed (413) »

Environnement
- URL : https://app.example.com/projects/218/files
- Chrome 154 et Firefox 158, Windows 11, réseau du bureau

Étapes de reproduction
1. Ouvrir un projet, puis l’onglet Fichiers.
2. Cliquer sur « Téléverser » et choisir un PDF de plus de 10 Mo
   (testé : 10,4 Mo, 12 Mo, 25 Mo).

Résultat attendu
Le fichier est téléversé et apparaît dans la liste.

Résultat obtenu
La barre de progression atteint environ 90 %, puis « Upload failed (413) ».
Réseau : POST /api/files a renvoyé 413 Request Entity Too Large,
le corps de la réponse est une page d’erreur HTML, pas du JSON.
Console : Uncaught (in promise) SyntaxError: Unexpected token '<'

Fréquence
Toujours pour les fichiers de plus de 10 Mo (6/6). Jamais pour les fichiers de moins de 9 Mo (0/8).

Pièces jointes
- Enregistrement d’écran d’un téléversement en échec (40 secondes)
- Fichier HAR nettoyé d’une tentative

Pourquoi ça marche

Le bug « aléatoire » dépendait en fait de la taille du fichier, et la personne l’a prouvé avec des décomptes des deux côtés du seuil. Le statut 413 et la réponse HTML désignent une limite de taille quelque part en amont de l’application, et l’erreur console explique pourquoi l’utilisateur a vu un message générique : l’application a essayé de lire une page HTML comme du JSON. Le fichier HAR est nettoyé, car les fichiers HAR contiennent des cookies et des tokens ; le nettoyeur HAR les retire dans votre navigateur.

Transformer un rapport faible en rapport solide

Si vous triez les bugs pour une équipe de support ou de QA, vous recevrez beaucoup de rapports comme les versions faibles ci-dessus. Les réécrire est plus rapide que de les renvoyer, à condition d’obtenir les réponses à cinq questions :

  1. Qu’avez-vous vu exactement ? Demandez le texte de l’erreur ou une capture d’écran, pas une description.
  2. Où étiez-vous ? L’URL ou le nom de l’écran, et le compte.
  3. Qu’avez-vous fait juste avant ? Les deux ou trois dernières actions suffisent généralement pour commencer à reproduire.
  4. Est-ce que ça arrive à chaque fois ? Sinon, à quelle fréquence environ, et quelque chose semble-t-il le rendre plus probable ?
  5. Qu’essayiez-vous de faire ? Cela vous donne le résultat attendu et l’impact réel.

Posez les cinq dans un seul message. Les personnes qui signalent un bug, surtout les clients, répondent volontiers à une série de questions ; au bout de trois, elles abandonnent. Une fois les réponses obtenues, essayez de reproduire le bug vous-même et ajoutez ce que vous apprenez, comme les comparaisons des exemples ci-dessus. Un bug reproduit, accompagné de vos propres preuves, avance bien plus vite dans la file qu’un e-mail transféré.

Ce que les bons exemples ont en commun

  • Des titres qui décrivent le symptôme et la condition, pas seulement la fonctionnalité.
  • Un point de départ connu et les données exactes utilisées.
  • Des chiffres et des textes d’erreur exacts, jamais « faux » ou « une erreur ».
  • Une comparaison : un autre compte, appareil, mois ou taille de fichier où ça fonctionne.
  • Des preuves jointes, secrets retirés.
  • Des hypothèses présentées comme des hypothèses.

Capturer les preuves plus vite

La plupart des versions solides ci-dessus ont eu besoin de la console et du panneau Network. Midge, une extension Chrome gratuite, capture les deux pendant que vous enregistrez votre écran ou prenez une capture d’écran. Chaque enregistrement contient les logs console, les requêtes réseau, les actions utilisateur et les infos sur l’appareil. Mots de passe, numéros de carte, tokens et cookies sont masqués dans votre navigateur avant que quoi que ce soit ne quitte votre appareil. Vous écrivez toujours le titre, les étapes et le résultat attendu ; les détails techniques sont joints d’office.

Guides associés

Questions fréquentes

À quoi ressemble un bon exemple de rapport de bug ?

Il a un titre précis, l’environnement, des étapes numérotées partant d’un point de départ connu, le résultat attendu et le résultat obtenu avec le texte exact des erreurs, la fréquence, et des preuves comme une capture d’écran, une erreur console ou une requête en échec.

Quelle est l’erreur la plus courante dans les rapports de bug ?

Des étapes de reproduction absentes ou vagues. Sans elles, le développeur doit deviner comment le bug s’est produit, ce qui finit souvent par un ticket fermé avec la mention « impossible à reproduire ».

Un rapport de bug doit-il inclure une capture d’écran ?

Oui, quand le problème est visible. Ajoutez aussi le texte de l’erreur, car un texte peut être recherché et copié, et ajoutez un court enregistrement quand le bug implique plusieurs étapes ou une question de timing.

Où trouver une version vierge de ce format ?

Utilisez le modèle de rapport de bug à copier-coller de la documentation Midge. Il a les mêmes champs que les bons exemples de cette page.