MacOS下.NET 8 MAUI应用使用HttpListener遇权限拒绝问题求助

一、MacOS桌面应用需要额外权限配置 #

MacOS的App Sandbox机制会对打包后的桌面应用做严格权限管控，MAUI默认会给MacOS应用启用沙箱。HttpListener监听端口属于传入网络连接操作，默认沙箱配置没有开放这个权限，所以调用listener.Start()时会触发Permission denied错误。

二、NUnit测试能成功的原因 #

NUnit测试进程不属于MacOS的“沙箱打包应用”范畴，它是以普通控制台进程的形式运行，不受App Sandbox的权限限制，因此可以正常绑定端口并启动监听。

三、解决步骤 #

1. 添加网络权限配置 #

在MAUI项目的Platforms/MacOS/Info.plist文件中，添加传入网络连接权限的配置：

<key>com.apple.security.network.server</key>
<true/>

如果你的应用同时需要对外发起网络请求，也可以补充传出权限（非必需，但能避免后续其他网络操作的权限问题）：

<key>com.apple.security.network.client</key>
<true/>

2. 检查端口占用情况 #

如果添加权限后仍报错，先确认5000端口是否被其他进程占用，执行以下命令排查：

lsof -i :5000

若有占用进程，可通过kill -9 <进程PID>杀掉进程，或者更换监听端口。

3. 调试配置确认 #

在Visual Studio for Mac中调试时，确保MacOS项目的调试配置没有强制启用严格沙箱限制（默认调试模式下沙箱管控会宽松，但发布版必须配置权限才能正常运行）。

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