使用非本地IP时HttpAddUrl返回ERR_INVALID_NETNAME错误排查

针对你遇到的问题——使用非本地IP调用HttpAddUrl返回1214错误码，即使已用管理员权限启动程序，以下是几个核心原因和解决办法：

核心原因1：目标IP未绑定到本地网卡 #

HttpAddUrl要求绑定的IP地址必须是本地网卡已配置的有效地址。如果使用的是公网IP（比如37.123.43.x），大概率这个IP并非直接配置在你的本地网卡上，而是运营商通过NAT映射到你的网络的。这种情况下，系统无法识别该IP为本地网络名称，因此返回ERR_INVALID_NETNAME。

解决办法 #

• 若需监听所有本地可用IP（包括内网和映射后的公网IP），将URL中的IP替换为0.0.0.0，例如：http://0.0.0.0/someUrl。这样服务器会监听所有网卡的请求，公网请求通过NAT转发后也能被处理。
• 若必须绑定特定IP，先在本地网卡上手动添加该IP：
  1. 打开「网络连接」属性，找到「Internet协议版本4(TCP/IPv4)」。
  2. 点击「属性」→「高级」，在「IP地址」栏点击「添加」，输入目标IP和对应的子网掩码，保存后再尝试调用HttpAddUrl。

核心原因2：URL预留冲突（可能性较低） #

虽然1214错误更偏向网络名称问题，但如果目标URL已被其他程序通过netsh http add urlacl预留，也可能触发类似错误。

排查方法 #

打开管理员权限的命令提示符，执行以下命令查看已预留的URL：

netsh http show urlacl

如果发现你要绑定的URL已被占用，可以删除该预留（netsh http delete urlacl url=http://xxx/someUrl）后重新尝试。

核心原因3：防火墙或安全软件拦截 #

部分防火墙或安全软件可能会阻止程序绑定非本地IP地址，即使拥有管理员权限。

排查方法 #

暂时关闭系统防火墙和第三方安全软件，重新运行程序测试是否能成功添加URL。如果问题解决，需要在防火墙中为你的程序添加允许绑定网络的规则。

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