HttpListener创建抛出SocketException：请求地址上下文无效问题

我之前也碰到过一模一样的情况，结合你提到的Mono源码排查方向，这个问题基本都和地址配置的格式、权限或者Mono特有的解析逻辑脱不了干系，下面给你梳理具体的原因和解决办法：

问题核心定位 #

从你描述的现象和异常信息来看，问题出在HttpListener绑定的地址前缀上。翻了Mono的EndPointManager里GetEPListener方法的逻辑后，会发现它对地址格式的校验、权限的检查比.NET Framework严格得多，稍有不符合就会抛出这个SocketException。

常见原因及解决方案 #

1. 地址前缀格式不规范 #

这是最常见的诱因，Mono对HttpListener的前缀格式要求很苛刻，必须满足：

• 协议只能是http或https（https需要额外配置证书）
• 必须包含端口号（除非用默认的80/443端口）
• 前缀末尾必须带有/
• 主机名要么是具体IP、localhost，要么是*（代表绑定所有网卡）

错误示例：

// 缺少末尾斜杠，Mono会判定格式无效
listener.Prefixes.Add("http://*:8080/api");
// 非默认端口却省略端口号
listener.Prefixes.Add("http://localhost/api/");

正确示例：

// 绑定所有网卡的8080端口，前缀为/api
listener.Prefixes.Add("http://*:8080/api/");
// 绑定本地回环地址的默认80端口
listener.Prefixes.Add("http://127.0.0.1/");

2. 端口权限不足 #

在Mono环境中，绑定1024以下的端口需要管理员或root权限，如果普通用户运行程序尝试绑定这类端口，就会触发该异常。

解决办法：

• 要么切换到1024以上的端口（比如8080、9000这类常用端口）
• 要么以管理员/root身份启动程序（Linux下用sudo，Windows右键选“以管理员身份运行”）

3. 地址不可用或端口被占用 #

如果绑定的IP地址在当前机器的网卡上不存在，或者目标端口已经被其他程序占用，也会抛出这个异常。

排查与解决：

• 先写一段最简测试代码绑定http://127.0.0.1:8080/，验证本地回环地址是否能正常工作
• 用端口排查工具检查目标端口是否被占用：

  # Linux/Mac环境
  netstat -tulpn | grep 你的端口号
  # Windows环境
  netstat -ano | findstr :你的端口号
  

• 如果端口被占用，要么停止占用端口的程序，要么换一个未被使用的端口

4. Mono特有的主机名解析问题 #

有时候在Mono中，localhost的解析可能和127.0.0.1不一致，尝试把localhost替换为127.0.0.1，或者反之，可能莫名其妙就解决了问题。

快速验证步骤 #

1. 先写一段最简测试代码，绑定http://127.0.0.1:8080/，看是否能正常启动HttpListener
2. 如果正常，再逐步修改为你原来的地址，一步步排查是哪部分出了问题
3. 检查程序运行的权限，确保有绑定目标端口的权限

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