FastAPI服务本地网络无法访问，排查防火墙CORS仍未解决

以下是针对问题的具体排查点：

• 绑定地址错误：FastAPI默认仅绑定127.0.0.1（本地回环），这会导致局域网IP无法访问。必须显式指定监听0.0.0.0或具体局域网IP：

  • 启动命令改为：uvicorn main:app --host 0.0.0.0 --port 8000 --reload
  • 或在代码中配置：

    if __name__ == "__main__":
        uvicorn.run("main:app", host="0.0.0.0", port=8000, reload=True)
    

  这是此类问题最常见的原因，若本地用127.0.0.1:8000能访问但局域网IP不行，基本就是绑定地址的问题。

• 端口或进程异常：

  • 检查8000端口是否被其他进程占用：
    Windows：netstat -ano | findstr :8000
    Linux/macOS：lsof -i :8000
  • 确认FastAPI进程是否正确监听端口，可重启进程后再次验证。

• 网络配置问题：

  • 确认你使用的192.168.X.X是当前活跃网卡的IP（比如机器有多个网卡时，可能绑定了错误的网卡）。
  • 先测试本地回环访问：curl 127.0.0.1:8000/docs，如果能通，说明是绑定地址问题；如果也不通，说明进程内部有阻塞或未正常启动。

• 安全软件拦截：

  • 即使关闭了专用网络防火墙，公共网络防火墙或第三方杀毒软件、安全工具仍可能拦截8000端口流量，可临时关闭所有安全软件测试。

• 应用内部阻塞：

  • 检查FastAPI启动时的初始化逻辑，比如是否有同步执行的耗时操作（如大文件加载、数据库连接超时），这类操作会导致进程无法响应请求，且日志可能无报错。尝试注释掉初始化代码后重启测试。

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