Flutter+Appwrite用户认证遇Failed host lookup错误求排查方案

• 验证Docker端口映射
  执行docker ps查看Appwrite容器的端口映射情况，确保80端口绑定到0.0.0.0:80或你的主机IP，而非仅127.0.0.1:80。如果是后者，修改docker-compose.yml中的端口映射为80:80，然后重启容器：

  docker-compose down && docker-compose up -d
  

• 本地端口可达性测试
  在运行Appwrite的主机上执行curl http://[你的主机IP]:80/v1/health，检查是否返回健康状态JSON。如果本地访问失败：

  • 用lsof -i :80（Linux/macOS）或netstat -ano | findstr :80（Windows）检查80端口是否被其他进程占用，如有则停止占用进程或更换Appwrite端口。
  • 查看Appwrite容器是否正常运行：docker-compose ps，若状态异常，检查容器启动日志。

• 防火墙与安全组排查

  • 主机防火墙：开放80端口的TCP入站请求。Linux下执行sudo ufw allow 80/tcp（ufw）或firewall-cmd --add-port=80/tcp --permanent && firewall-cmd --reload（firewalld）；Windows需在防火墙高级设置中添加入站规则。
  • 云服务器安全组：确保云服务商的安全组规则允许80端口的外部访问。

• Appwrite环境配置检查
  打开docker-compose.yml，确认_APP_HOSTNAME配置项设置为你的主机IP（局域网/公网），而非localhost。修改后重启Appwrite容器：

  docker-compose down && docker-compose up -d
  

• 跨设备网络测试
  用同一局域网内的其他设备（如手机、另一台电脑）在浏览器中访问http://[主机IP]:80/v1/health，若无法访问，排查主机网络路由设置或Docker网络模式（默认bridge模式需确保端口映射正确）。

• 查看Appwrite服务日志
  执行docker-compose logs appwrite查看服务日志，排查是否有启动失败、数据库连接错误等异常信息，定位服务本身的问题。

内容的提问来源于stack exchange，提问作者Jordan Hancock