Strapi接口Postman与Flutter请求返回502错误如何修复

云原生阿岚

2026-8-26

根本原因

502属于网关错误，代表请求没有被正确转发到Strapi服务进程，结合你描述的现象，问题触发点按出现概率从高到低排序：

最开始Postman用localhost请求正常、Flutter端请求localhost报错是正常现象：Strapi默认开发配置仅绑定127.0.0.1回环地址，只有本机发往localhost的请求能被服务接收；Flutter运行在模拟器/真机上时属于独立网络节点，请求localhost指向的是Flutter运行环境自身，根本触达不到开发机上的服务。
换本机IP后暂时恢复、后续Postman和Flutter都报502的核心诱因：
1. Strapi服务没有配置监听所有网卡地址，服务重启、局域网IP续租变动、网络切换后，之前填写的临时IP不再和Strapi监听的端口绑定，请求无法到达服务进程。
2. 请求地址漏写Strapi默认服务端口1337：你贴的Flutter请求代码里地址没有带端口，默认会请求80端口，如果没有在80端口配置指向Strapi的反向代理，请求打到错误端口会直接被网关拦截返回502。
3. 如果用Docker部署Strapi，端口映射默认绑定了127.0.0.1，没有对外开放到所有网卡，外部设备（包括真机、独立网络栈的模拟器）的请求会被Docker代理拦截返回502。
4. 系统防火墙入站规则失效，拦截了对应端口的外部请求，导致请求无法到达Strapi进程。

修复方案

按以下顺序逐一排查配置：

修改Strapi监听配置
打开Strapi项目下的config/server.js（TS项目为config/server.ts），将host参数修改为0.0.0.0，让服务监听所有网卡的请求，配置参考：
```
module.exports = ({ env }) => ({
  host: env('HOST', '0.0.0.0'),
  port: env.int('PORT', 1337),
  app: {
    keys: env.array('APP_KEYS'),
  },
});
```
修改完成后重启Strapi服务生效。
修正端口与部署配置
- 如果没有配置Nginx等反向代理，所有请求Strapi的地址都要带上默认端口1337，正确格式为http://你的IP:1337/api/xxx。
- 如果用Docker部署Strapi，启动容器时端口映射要明确绑定所有网卡，命令示例：docker run -p 0.0.0.0:1337:1337 你的Strapi镜像名，避免默认仅绑定回环地址。
- 检查系统防火墙入站规则，放通1337端口的TCP请求，不要做IP段限制。
适配Flutter端调试配置
根据调试场景选择正确的服务地址，避免IP频繁变动：
- Android模拟器调试：直接用专用映射地址10.0.2.2，该地址默认指向开发机宿主机，不需要查询本机局域网IP，不受网络切换影响，地址写为http://10.0.2.2:1337/api/pelargoniums即可。
- iOS模拟器调试：直接用http://localhost:1337即可访问宿主机服务。
- 真机调试：确保真机和开发机连接同一WiFi，给开发机在路由器后台绑定静态局域网IP，避免IP续租变动导致请求失效。
- Android端调试还需要补充网络配置：打开android/app/src/main/AndroidManifest.xml，添加网络权限并允许明文HTTP请求：
```

<uses-permission android:name="android.permission.INTERNET"/>
<application
  android:usesCleartextTraffic="true"
  
>
```
链路验证
所有配置修改完成后，先在Postman里请求http://你使用的IP:1337/api/pelargoniums，确认返回200状态码后，再从Flutter端发起请求即可。

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