Node.js下test.localhost解析失败：与Chrome差异及优雅修复咨询

现象复现 #

系统域名解析测试 #

在Mac终端执行系统域名查询命令，可见默认仅能解析localhost，无法解析其子域名：

$ dscacheutil -q host -a name localhost     
name: localhost
ipv6_address: ::1

name: localhost
ip_address: 127.0.0.1

$ dscacheutil -q host -a name test.localhost
# not found

Node.js服务与请求测试 #

1. 启动本地Node.js服务：

// Node终端1作为服务端
const http = require('http');
http.createServer((request, res) => {
  res.write('Working!');
  res.end();
}).listen(3000);

2. 请求测试结果：

// 失败：Uncaught AxiosError: getaddrinfo ENOTFOUND test.localhost
await axios.get("http://test.localhost:3000")

// 成功：
await axios.get("http://localhost:3000")

断开WiFi后请求test.localhost必失败，更换网络环境后即使连WiFi也出现同样解析失败问题。

核心疑问 #

1. 为什么Chrome中使用Axios请求test.localhost正常，但Node.js中会报错？
2. 如何在不修改/etc/hosts、不使用Node.js专属模块的前提下，优雅修复Node.js端的解析问题？
3. Chrome与Node.js解析localhost的具体差异是什么？

问题解析与解决方案 #

一、Chrome与Node.js解析差异的原因 #

• Chrome（浏览器）：自Chrome 63版本起，内置了*.localhost域名的解析规则，会自动将所有以.localhost结尾的子域名直接映射到127.0.0.1和::1，完全绕过系统DNS服务，因此无需依赖系统配置即可正常解析。
• Node.js：遵循POSIX标准，直接调用系统底层的getaddrinfo函数进行域名解析，依赖macOS的系统DNS缓存（即dscacheutil查询的结果）。而macOS默认系统配置中没有*.localhost的通配符解析规则，当系统找不到对应域名的记录时，就会返回getaddrinfo ENOTFOUND错误。

二、优雅修复Node.js端的方案（符合需求限制） #

由于要求前后端代码通用、不修改系统配置、不使用Node专属模块，可以通过编写通用的URL替换工具函数来解决：

// 通用工具函数：将localhost子域名替换为localhost
function fixLocalhostSubdomain(url) {
  return url.replace(/([a-zA-Z0-9-]+)\.localhost/g, 'localhost');
}

// 使用示例
await axios.get(fixLocalhostSubdomain("http://test.localhost:3000"));

该函数会将所有xxx.localhost格式的域名替换为localhost，前后端环境均可运行，无需额外配置或依赖。

三、Chrome与Node.js解析localhost的具体差异对比 #

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