VUE 请求代理地址localhost报错[HPM] Error occurred while trying to proxy request

目录

前言

问题排查

网络联通性测试

[ping localhost](#ping localhost)

[ping 127.0.0.1](#ping 127.0.0.1)

问题结论

解决方案

[强制使用 IPv4](#强制使用 IPv4)

[修改localhost 为127.0.0.1](#修改localhost 为127.0.0.1)

[localhost 与 127.0.0.1 的区别](#localhost 与 127.0.0.1 的区别)


前言

今天前后端联调测试vue报错,HPM Error occurred while trying to proxy request /getSystemTime from 127.0.0.1 to http://localhost:8080/api/ (ETIMEDOUT) (https://nodejs.org/api/errors.html#errors_common_system_errors),意思是这个请求uri /getSystemTime 请求到服务地址 http://localhost:8080 超时报错了,但是后端服务是正常启动的,

问题排查

这个问题在于 (ETIMEDOUT)也就是请求超时,vue客户端和服务端网络握手没有成功。正常来说localhost作为回环地址:允许计算机与自身进行网络通信,而不需要经过物理网络接口(如网卡)。所以可以在本地运行一个 Web 服务器,然后通过客户端访问 http://localhost:8080 服务。

网络联通性测试

ping localhost

通过ping localhost命令进行测试发现返回 ::1 (IPv6)

ping 127.0.0.1

通过 ping 127.0.0.1命令进行测试发现返回了127.0.0.1

所以通过上面测试发现 localhost 是一个特殊的主机名,它指向当前计算机本身,对应的 IP 地址是 127.0.0.1 (IPv4)或 ::1(IPv6)。

问题结论

vue请求的后端服务只监听了 IPv4,而vue发送localhost的地址请求被解析为ipv6的回环地址,所以请求不通。即 localhost -> 连接到 ::1:8080 -> 连接失败,而使用 127.0.0.1 -> 连接到 127.0.0.1:8080 -> 连接成功。

解决方案

强制使用 IPv4

在 hosts 文件中添加配置(需要管理员权限)Windows位置: C:\Windows\System32\drivers\etc\hosts,

Linux/Mac位置: /etc/hosts。

配置如下所示

127.0.0.1 localhost

::1 localhost # 可以注释掉这行

修改localhost 为127.0.0.1

将vue代理请求更换成127.0.0.1即可。

javascript 复制代码
   proxyTable: {
      '/api': {
          //target: 'http://localhost:8080/api/',
          target: 'http://127.0.0.1:8080/api/',
          changeOrigin: true,
          pathRewrite: {
            '^/api': ''
          }
        }
    },

localhost 与 127.0.0.1 的区别

对比项 localhost 127.0.0.1
本质 主机名(域名) IPv4 地址
解析 需要 DNS 解析 直接指向本地
IPv6 可能解析为 ::1 固定 IPv4 地址
系统 hosts 可能被修改 固定不变
连接速度 稍慢(需解析) 直接连接
相关推荐
Flynn Liang10 小时前
HikariCP 连接池不是越大越好:I/O 密集型 Java 服务的数据库容量工程
java·数据库·mysql·高并发·连接池·hikaricp·sql 优化
学长毕设11 小时前
基于SpringBoot社区快递驿站物流配送系统-附源码
java·spring boot·后端
Flynt11 小时前
Java4Shell 实测:EPYC 一跑就中招,关掉 Base64 硬件加速,1KB 解码慢 14 倍
java·安全·性能优化
Resean022311 小时前
Spring 源码分析(七)AOP 原理(上):代理的创建
java·后端·spring
Tangq一定可以的11 小时前
Spring AI Advisor 详解 - 给大模型调用加上“切面“,日志/过滤/记忆一键搞定
java·后端·spring
小巫编程室12 小时前
我造了一个 Java 能力包:让 AI 直接调用你的业务代码
java·前端·后端
雾隐隐o12 小时前
优搭校园 01|项目概览、技术选型与初始化
spring boot·mysql·vue
深入云栈13 小时前
Netty 4.2.x 源码深度解析 (二十四):池化内存分配 —— PoolArena、PoolChunk 与 PoolSubpage
java·后端·架构
惜.己14 小时前
Java结合idea简单使用Playwright
java·开发语言·自动化
Vex2une14 小时前
JDK 8 下载安装与环境变量配置完整指南(Windows新手图文教程)
java·windows·环境配置·环境变量·jdk8·jdk下载安装·java入门教程