Parcel本地localhost服务无法连接：“无法访问此网站，localhost拒绝连接”

问题背景 #

之前用Parcel开发一切正常，突然无法通过http://localhost:1234/访问本地服务，构建过程无任何报错，浏览器提示“无法访问此网站，localhost拒绝连接”，但用npx serve可以正常提供服务。使用的依赖版本：

"@parcel/transformer-sass": "^2.7.0",
"parcel": "^2.7.0",
"sass": "^1.26.10"

排查与解决步骤 #

• 检查端口占用情况
  1234端口可能被其他进程占用，Parcel默认端口被占时会自动切换，但偶尔可能没有正常提示。

  • Windows执行：netstat -ano | findstr :1234，找到占用进程的PID后，打开任务管理器杀掉对应进程；
  • Mac/Linux执行：lsof -i :1234，用kill -9 <PID>杀掉进程。
    之后重新启动Parcel，或者直接指定其他端口启动：

  parcel index.html -p 5678
  

• 清理Parcel缓存
  缓存损坏可能导致服务异常，删除项目根目录下的.parcel-cache和dist文件夹，然后重新执行parcel index.html启动服务。

• 仔细查看启动日志
  启动Parcel时盯着终端输出，有时候会提示端口切换（比如Server running at http://localhost:xxxx/），如果端口不是1234，直接用新端口访问即可。

• 调整依赖版本
  当前使用的sass@1.26.10版本较旧，和parcel@2.7.0可能存在兼容性问题。尝试更新sass到最新版本：

  npm install sass@latest
  

  如果更新后出现新问题，可以尝试回退到之前能正常工作的Parcel版本（若记得具体版本号）。

• 检查hosts文件映射
  确保本地hosts文件中127.0.0.1 localhost的映射未被篡改：

  • Windows路径：C:\Windows\System32\drivers\etc\hosts
  • Mac/Linux路径：/etc/hosts
    用管理员权限打开文件，确认该映射存在且未被注释。

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