« Could not connect to the server » (NSURLErrorDomain -1004) sur Mac
L’app a trouvé l’adresse du serveur, mais la connexion ne s’est pas ouverte. Le serveur l’a refusée, ou quelque chose sur le trajet l’a bloquée.
Mon Mac a ce problème : « Could not connect to the server » (NSURLErrorDomain -1004) sur Mac. Lis https://kilobat.app/fr/guides/nsurl-error-1004-could-not-connect-to-the-server.md et résous-le avec moi. Installe la CLI Kilobat si elle manque : brew install seifip/kilobat/kilobat. Lance toi-même les vérifications Terminal et kilobat du guide et dis-moi ce que tu trouves. Liste les étapes que moi seul peux faire. Demande-moi avant de modifier un réglage.
Symptômes
- Une app affiche « Could not connect to the server. » avec l’erreur -1004.
- La Console ou un journal affiche NSURLErrorDomain Code=-1004.
- Safari affiche le message voisin « can’t connect to the server ».
Causes probables
- Le serveur est en panne ou n’écoute pas. Rien n’accepte les connexions sur ce port.
- Un serveur local ne tourne pas. Pour
localhost, votre propre serveur doit tourner. Voir Port déjà utilisé sur Mac. - Un coupe-feu, un filtre, un VPN ou un proxy. Quelque chose bloque le port ou l’hôte.
- Une adresse ou un port incorrect. L’app utilise une ancienne URL.
Comment vérifier
Testez le port avec un délai de 5 secondes.
nc -vz -G 5 example.com 443Demandez la page et affichez chaque étape de la connexion.
curl -v -o /dev/null https://example.comPour une adresse locale, regardez ce qui écoute sur le port.
lsof -nP -iTCP:3000 -sTCP:LISTEN
Comment corriger
Ouvrez la même adresse sur un autre appareil. Si cela échoue aussi, la cause est le serveur ou le réseau.
Démarrez le serveur local et utilisez le port qu’il indique.
Désactivez un VPN, un proxy ou un filtre pour un test, puis réactivez-le.
Vérifiez dans l’app que l’URL contient le bon hôte et le bon port.
Réessayez plus tard. Un serveur occupé peut se rétablir.
Avec Kilobat
Vérifiez en une seule étape le Wi-Fi, le routeur, Internet, le DNS et les pages de connexion.
kilobat diagnoseSi un seul site ou service échoue, trouvez la couche qui le bloque.
kilobat why example.comLa CLI est gratuite. Dans l’app, les conseils issus de ces vérifications font partie de Kilobat Pro. Voir Trouver pourquoi un site ou une API ne se connecte pas.
Questions
En quoi -1004 diffère-t-il de -1001 ?
-1004 est une connexion refusée ou bloquée. -1001 est un dépassement de délai. Voir « The request timed out. » sur Mac.
Pourquoi localhost donne-t-il -1004 ?
Rien n’écoute sur le port, ou le serveur écoute sur une autre adresse.
Sources
- Texte d’erreur dans CFNetwork.framework, macOS 27.2 (Localizable.loctable)
- curl(1) et nc(1), page de manuel installée avec macOS 27.2
Vérifié le 29 octobre 2026.