为何使用localhost而非127.0.0.1会引发Gatsby-Strapi连接报错？

核心原因拆解 #

• DNS解析优先级问题
  localhost是域名，需要系统通过DNS或hosts文件解析为IP地址。多数系统默认会同时映射localhost到IPv4的127.0.0.1和IPv6的::1，但部分环境下解析时会优先选择IPv6地址。如果你的Strapi服务只监听了IPv4的回环接口（默认配置可能如此），当Gatsby插件用localhost发起请求时，实际连接的是IPv6的::1，而Strapi没在这个地址上监听，就会抛出ECONNREFUSED错误。直接用127.0.0.1则跳过了解析步骤，直接连接IPv4的监听地址，自然能成功。

• Strapi的监听范围限制
  查看Strapi的config/server.js配置文件，如果host字段设置为127.0.0.1，意味着服务仅绑定IPv4的回环接口，不会响应IPv6的连接请求。此时若localhost解析为::1，连接必然失败。把host改成0.0.0.0（监听所有IPv4接口）或::（同时监听IPv4和IPv6），就能让localhost的请求正常被处理。

• HTTP客户端的解析行为差异
  gatsby-source-strapi插件底层使用的HTTP客户端，在处理localhost域名时的解析逻辑可能和直接输入IP不同。比如部分客户端会优先尝试IPv6连接，而Strapi未开启IPv6支持的话，就会触发连接拒绝错误。

可行的解决办法 #

1. 调整Strapi的监听配置：修改config/server.js中的host为0.0.0.0，保存后重启Strapi服务，之后用localhost:1337就能正常连接。
2. 检查系统hosts文件：确保localhost明确映射到127.0.0.1（部分系统可能因配置问题导致解析异常）。
3. 临时替代方案：继续使用127.0.0.1:1337作为API地址，不影响开发流程。

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