SLES15 SP5中localhost映射IPv6而非IPv4的Electron调用问题

问题背景 #

• 开发环境：Linux下的ElectronJS应用，在SLES15 SP4运行正常，升级至SP5后无法调用REST接口
• 故障现象：调用http://localhost:8080/v1/myapp时，localhost被解析为IPv6地址::1，触发连接拒绝错误：Error: connect ECONNREFUSED ::1:8082
• 当前/etc/hosts配置：

  127.0.0.1       localhost
  ::1     localhost ipv6-localhost ipv6-loopback
  

• 限制条件：不能注释::1相关配置，需保留原hosts文件解决问题

差异原因 #

SLES15 SP5调整了系统默认的地址解析优先级，相比SP4优先选择IPv6地址。尽管/etc/hosts中同时存在localhost的IPv4和IPv6映射，但系统遵循RFC 3484的地址选择算法，SP5默认配置让IPv6的::1优先级高于IPv4的127.0.0.1，导致解析顺序变化。

解决方案 #

方案1：在Electron代码中强制使用IPv4解析 #

针对请求代码配置强制IPv4解析，避免系统优先选IPv6：

• 使用Node.js原生http/https模块时，添加family: 4参数：

  const http = require('http');
  const requestOptions = {
    hostname: 'localhost',
    port: 8080,
    path: '/v1/myapp',
    method: 'GET',
    family: 4 // 强制解析为IPv4地址
  };
  
  const req = http.request(requestOptions, (res) => {
    // 处理响应逻辑
  });
  
  req.on('error', (err) => {
    console.error('请求错误:', err);
  });
  req.end();
  

• 使用axios时，可覆盖DNS lookup逻辑强制IPv4：

  const axios = require('axios');
  const dns = require('dns');
  
  // 保存原生lookup方法
  const originalLookup = dns.lookup;
  // 针对localhost强制IPv4解析
  dns.lookup = (hostname, opts, callback) => {
    if (hostname === 'localhost') {
      return originalLookup(hostname, { ...opts, family: 4 }, callback);
    }
    return originalLookup(hostname, opts, callback);
  };
  
  // 正常发起请求
  axios.get('http://localhost:8080/v1/myapp')
    .then(res => console.log('响应数据:', res.data))
    .catch(err => console.error('请求失败:', err));
  

方案2：调整系统地址解析优先级 #

修改/etc/gai.conf配置，让IPv4优先级高于IPv6：

1. 打开/etc/gai.conf文件
2. 添加或取消注释以下配置行：

   precedence ::ffff:0:0/96  100
   

   该配置会让IPv4映射的IPv6地址（涵盖所有IPv4地址）优先级高于原生IPv6地址，从而让localhost优先解析为127.0.0.1
3. 保存文件后，新的网络请求会自动应用该优先级，无需重启系统

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