用过微信开发者工具的人，十有八九遇到过那个让人头大的报错：加载失败，状态码502。页面一片空白，控制台红字刷刷跳，项目明明本地跑得好好的，怎么就“网关错误”了？别慌，这问题没你想得那么复杂。
502是啥？先搞清本质
502 Bad Gateway 说白了就是“中间人撂挑子”。你本地启动的服务（比如localhost:8080）本该由开发者工具代理访问，但工具连不上这个服务，或者后端服务器响应异常，就会抛出502。常见于本地开发服务器崩溃、端口被占、配置出错等情况。
第一步：重启不是玄学，真有用
别笑，很多问题重启一下就没了。关掉微信开发者工具，顺手把任务管理器里残留的进程也清一清。再重新打开工具，重新编译项目。有时候只是某个临时连接卡住了，重启相当于“拍一下路由器”，简单粗暴但有效。
检查本地服务是否正常
微信开发者工具依赖本地启动的服务。比如你用的是Vue或React项目，得先在命令行运行 npm run dev 启动本地服务器。如果这个服务根本没起来，工具当然拿不到资源。
打开终端，进项目目录，确认服务是否成功监听了指定端口。比如看到类似这样的输出：
Local: http://localhost:8080
Network: http://192.168.1.100:8080说明服务正常。如果报错端口被占用，换一个端口，然后在微信开发者工具里同步修改项目配置。
修改项目中的服务器地址
有些项目默认请求线上接口，但你在本地调试时网络不通，也会导致502。比如项目里写着：
axios.get('https://api.example.com/user')这时候可以临时改成本地代理地址，或者在微信开发者工具的“详情”->“本地设置”里勾选“不校验合法域名”，先让请求发出去再说。
清除缓存和重装试试
缓存积多了也会出怪事。微信开发者工具自带“清除缓存”功能，在工具左上角“工具”菜单里能找到。点一下，再重新编译。要是还不行，考虑卸载重装最新版，旧版本有些已知bug会导致代理异常。
防火墙和杀毒软件别忽视
有些安全软件会拦截 localhost 的通信，尤其是企业电脑。试着暂时关闭防火墙或杀毒软件，看502是否消失。如果好了，就把微信开发者工具加个白名单，以后安心用。
其实502没那么可怕，大多数时候就是本地环境的小毛病。按步骤一步步排查，基本都能解决。开发嘛，踩坑才是常态，跨过去就又涨经验了。