MacBook上Sanity Studio服务器端口监听权限问题求助

1. 检查目标端口是否被占用 #

• 终端执行命令查看端口占用情况，将<端口号>替换为Sanity项目使用的端口（默认通常为3333）：

  lsof -i :<端口号>
  

• 如果输出结果中有进程信息，说明端口被占用，使用以下命令杀掉对应进程（<PID>替换为输出中的PID数值）：

  kill -9 <PID>
  

2. 验证localhost解析有效性 #

• 终端执行ping命令测试localhost连通性：

  ping localhost
  

• 如果无法正常返回数据包，检查hosts文件配置：
  1. 执行命令编辑hosts文件：

     sudo nano /etc/hosts
     

  2. 确保文件中存在以下两行配置：

     127.0.0.1 localhost
     ::1 localhost
     

  3. 按Ctrl+O保存，回车确认，再按Ctrl+X退出编辑。

3. 确认端口监听权限 #

• macOS中1024以下的端口需要root权限才能监听，如果你的Sanity项目使用了这类端口，需通过sudo启动：

  sudo sanity start
  

• 如果使用默认端口仍报错，尝试切换其他未被占用的端口启动：

  sanity start --port 4444
  

4. 排查防火墙或安全软件拦截 #

• 临时关闭系统防火墙测试：

  sudo /usr/libexec/ApplicationFirewall/socketfilterfw --setglobalstate off
  

• 若关闭后项目能正常启动，需重新配置系统防火墙规则，或检查第三方安全软件（如Little Snitch）是否拦截了Sanity的网络请求。

5. 重置Sanity本地配置 #

• 删除项目根目录下的.sanity文件夹，然后重新安装依赖：

  rm -rf .sanity
  npm install
  

• 重新启动Sanity项目尝试。

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