macOS端口监听失败主因是系统权限限制：需在隐私设置中启用“本地网络”权限，自打包应用须在entitlements中声明network.client/server，低端口建议改用8080等非特权端口或通过launchd托管。
macos 开发中端口监听失败，常见不是代码或配置问题，而是系统级权限限制。尤其监听 1–1023 的低端口（如 80、443），或启动本地服务时提示 eaddrinuse、permission denied、bind() failed，本质是 macos 对网络绑定和文件写入做了双重管控。
检查并放行「本地网络」访问权限
从 Catalina 起，macOS 默认阻止未授权应用访问本地网络（包括 localhost）。即使你的服务跑在 3000、8000 等端口，也会被拦截：
- 打开「系统设置 → 隐私与安全性 → 本地网络」
- 找到对应工具（如 “VS Code”、“Tauri Dev Server”、“Vite Preview”、“微信开发者工具”）
- 启用右侧开关（变蓝）；若没出现，先启动一次该工具再回来刷新列表
- 完全退出工具（右键 Dock 图标 → “退出”，不能只关窗口），然后重启
修正应用沙箱网络能力（自打包桌面应用必做）
Flutter、Electron、Tauri、Capacitor 等框架打包的 macOS 应用，默认无网络权限。仅用户手动开启「本地网络」不够，还需在构建阶段声明 entitlements：
- 编辑项目中的
macos/Runner/DebugProfile.entitlements和Release.entitlements - 添加以下两行（缺一不可）：
<key>com.apple.security.network.client</key><true/><key>com.apple.security.network.server</key><true/> - 监听本地端口（如
localhost:3000）必须开启network.server；仅发起请求才需network.client - 修改后执行 Xcode → Product → Clean Build Folder，再重新编译
绕过低端口（80/443）权限限制
开发环境无需死磕 80 端口。更安全、省事的做法是换端口或交由系统托管：
-
推荐改端口：把
nginx.conf或服务配置里的listen 80;改为listen 8080;，然后直接运行nginx（不用 sudo） -
必须用 80？走 launchd：用 Homebrew 官方服务托管，自动以 root 权限运行：
sudo brew services start nginxbrew services list | grep nginx（确认显示 started） - Tomcat、Spring Boot 等 Java 服务同理：改
server.port=8080，避免启动时因权限失败
排查第三方防火墙与 Gatekeeper 干扰
Little Snitch、Lulu、Murus 等工具会静默拦截入站连接，且不依赖系统防火墙：
- 点击菜单栏图标，查看实时日志——外网访问时是否出现 “Blocked incoming connection” 到你的端口？
- 临时退出该防火墙，用手机测 http://你的IP:端口，若恢复即确认问题源
- 放行规则建议按 端口 + TCP 协议 设置（比绑定进程更稳定，尤其对 node/python 启动的服务）
- 首次运行未签名工具（如自编译二进制、Shell 脚本）可能被 Gatekeeper 拦截：前往「系统设置 → 隐私与安全性」底部点「仍要打开」；或终端执行：
xattr -dr com.apple.quarantine "/Applications/YourApp.app"
