Flutter Linux应用调用本地FastAPI遇307重定向错误求助

问题分析 #

307是临时重定向状态码，要求客户端保持原请求方法和主体重新发送到目标地址。Postman会自动处理这类重定向，但Flutter的Dio/http包默认配置可能未正确跟进，或本地环境存在网络/服务器配置问题。

排查与解决方案 #

1. 修正FastAPI绑定地址 #

如果FastAPI仅绑定127.0.0.1，部分Linux应用（如Flatpak打包的Flutter应用）因沙箱隔离无法访问localhost。启动FastAPI时绑定所有网卡：

uvicorn main:app --host 0.0.0.0 --port 8000

同时在Flutter代码中使用本地IP（如192.168.x.x）替代localhost作为请求地址。

2. 调整Dio的重定向与状态码验证配置 #

默认Dio会将3xx状态码视为错误，需修改配置允许重定向并接受3xx状态：

final Dio _dio = Dio()
  ..options.followRedirects = true
  ..options.maxRedirects = 5
  ..options.validateStatus = (status) {
    // 接受200-399之间的状态码
    return status != null && status >= 200 && status < 400;
  };

修改后Dio会自动跟进重定向，且不会因307抛出异常。

3. 检查路由路径的斜杠一致性 #

FastAPI会自动对末尾无斜杠的路由进行重定向（如/token重定向到/token/）。确保Flutter请求的URL与FastAPI路由路径保持一致：

• 如果FastAPI路由是@app.post("/token/")，Flutter请求地址需为http://your-ip:8000/token/

4. 捕获重定向目标地址排查 #

在异常捕获中打印重定向的Location头，明确服务器引导的目标地址，定位问题根源：

catch (e) {
  if (e is DioException) {
    print("重定向目标: ${e.response?.headers['location']}");
  }
  return false;
}

5. 确认Linux应用的网络权限 #

若Flutter应用是Flatpak打包，需添加网络访问权限：

flatpak override --user --network=your-app-id

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