Résolution des erreurs de connexion - App POS Mobile
Ce document aide à résoudre les erreurs Network Error et 404 lors de la connexion depuis l'app mobile.
1. Serveur Laravel doit écouter sur toutes les interfaces
Problème : Par défaut, php artisan serve écoute uniquement sur 127.0.0.1 (localhost). Le téléphone ne peut pas s'y connecter.
Solution : Lancer Laravel avec --host=0.0.0.0 :
php artisan serve --host=0.0.0.0 --port=8001
Cela permet aux appareils du réseau local (dont ton téléphone) d'accéder à l'API.
2. Vérifier l'IP de ton PC
L'IP 192.168.0.102 dans la config peut avoir changé (DHCP).
- Ouvre PowerShell.
- Tape :
ipconfig - Cherche "Adresse IPv4" dans la section de ta carte Wi-Fi (ou Ethernet).
- Mets à jour
pos-mobile/src/config/api.tsavec cette IP si elle est différente.
3. Téléphone et PC sur le même réseau
- Le téléphone doit être sur le même Wi-Fi que le PC.
- Si le téléphone est en 4G/5G uniquement, il ne pourra pas joindre
192.168.x.x.
4. Tester depuis le navigateur du téléphone
- Ouvre le navigateur sur ton téléphone.
- Va sur :
http://192.168.0.102:8001 - Si tu vois la page Laravel → le réseau est OK.
- Si ça ne charge pas → problème réseau (IP, firewall, ou serveur mal lancé).
5. Pare-feu Windows
Le pare-feu peut bloquer le port 8001.
- Autoriser PHP ou le port 8001 dans le pare-feu Windows.
- Ou désactiver temporairement le pare-feu pour tester.
6. Android et HTTP (cleartext)
Sur Android 9+, les requêtes HTTP (non HTTPS) peuvent être bloquées.
La config usesCleartextTraffic a été ajoutée dans app.json pour autoriser HTTP en développement.
7. Erreur 404 "Request failed with status code 404"
Signification : Le téléphone atteint un serveur, mais l’URL appelée n’existe pas sur ce serveur.
Causes fréquentes :
- Vous testez en local mais l’app est configurée sur l’URL de production (
https://app.shopmanagerpro.net/api/mobile). Ce domaine ne pointe pas encore vers votre Laravel ou l’API n’y est pas déployée. - En production : le site n’est pas déployé à cette adresse, ou le serveur web (Nginx/Apache) ne transmet pas les requêtes
/api/*à Laravel.
Solution pour tester en local :
- Sur le téléphone, dans l’écran de connexion, appuyez sur « Configurer l’URL du serveur ».
- Saisissez l’URL de votre PC, par exemple :
http://192.168.1.10:8001/api/mobile
(remplacez par l’IP de votre ordinateur sur le réseau Wi-Fi — voiripconfig). - Enregistrez, puis reconnectez-vous avec Code boutique, Email et Mot de passe.
Prérequis : Laravel doit être lancé avec php artisan serve --host=0.0.0.0 --port=8001 pour que le téléphone sur le même Wi-Fi puisse y accéder.
Checklist rapide
- Laravel lancé avec
--host=0.0.0.0 --port=8001 - IP correcte dans
pos-mobile/src/config/api.ts - Téléphone et PC sur le même Wi-Fi
- Test dans le navigateur du téléphone :
http://TON_IP:8001