Nuxt3启动失败求助：getaddrinfo ENOTFOUND localhost及端口问题

针对localhost解析失败的问题 #

• 刷新MacOS DNS缓存
  根据你的系统版本执行对应命令：

  • Ventura（13.x）及以后版本：

    sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder
    

  • Monterey（12.x）：

    sudo killall -HUP mDNSResponder
    

• 验证localhost解析
  执行以下命令确认localhost能正常解析到本地回环地址：

  ping localhost
  nslookup localhost
  

  如果输出无法解析到127.0.0.1或::1，检查hosts文件权限：

  ls -l /etc/hosts
  

  正确权限应为-rw-r--r-- 1 root wheel，如果不符，修复权限：

  sudo chmod 644 /etc/hosts
  sudo chown root:wheel /etc/hosts
  

针对端口占用问题 #

• 检查并释放3000端口
  查看占用3000端口的进程：

  lsof -i :3000
  

  找到对应的PID，强制终止进程：

  kill -9 <PID>
  

• 强制Nuxt绑定指定地址和端口
  在项目根目录的nuxt.config.ts中添加服务器配置，明确绑定到本地回环地址：

  export default defineNuxtConfig({
    server: {
      host: '127.0.0.1',
      port: 3000
    }
  })
  

其他尝试 #

• 重启终端或电脑，清除可能的进程缓存
• 尝试临时切换到Node 16版本（部分环境下Node 18的DNS解析逻辑可能存在兼容性问题）

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