Windows服务部署HttpListener监听80端口无响应故障排查咨询

问题根因及遗漏配置项说明 #

1. HttpListener监听前缀配置错误

• 你日志中记录的已注册前缀http:///api/不符合HttpListener的官方规范，三个斜杠的写法等价于仅绑定本地回环地址127.0.0.1，不会监听所有网卡的0.0.0.0地址，因此不会出现在全局监听列表中。
• 要实现全网卡监听，正确的前缀格式应为http://+:80/api/（匹配所有解析到本机的主机名）或http://*:80/api/（匹配所有IP、主机名访问），且必须保留路径末尾的斜杠。

2. URL预留配置不匹配

你执行的netsh http add urlacl命令存在两处错误，导致权限预留不生效：

• URL参数缺少http://协议前缀，且路径末尾缺少斜杠，和服务注册的/api/前缀格式不一致。HTTP.sys的URL权限校验为严格匹配，格式、末尾斜杠的差异都会导致预留失效。
• 你预留的URL绑定了具体的<dns-name>，和服务需要监听所有网卡的需求不匹配，且如果服务注册的前缀使用通配符，二者不一致会导致服务没有权限启动监听。
• 正确的预留命令应为：

netsh http add urlacl url="http://+:80/api/" user="NT AUTHORITY\Local Service"

注意账号名中间存在空格，必须和服务运行身份完全一致。

3. 代码异常吞吃导致的假成功日志

HttpListener在出现前缀格式错误、无URL预留权限、端口被占用等问题时，调用Start()方法会直接抛出异常。如果你的代码中捕获了该异常却没有打错误日志，直接输出了“服务正常运行、前缀注册成功”的日志，会导致错误判断服务运行状态，建议优先检查HttpListener启动逻辑的异常处理代码。

4. 80端口被其他进程占用

• 执行命令netstat -ano | findstr ":80"检查80端口是否被IIS、Nginx、Apache等其他进程占用，如果存在占用需要停止对应进程，或者修改你的服务监听端口。
• 也可以执行netsh http show servicestate查看HTTP.sys当前注册的所有URL前缀，确认你的服务监听前缀是否真的注册成功。

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