近日，多位.NET开发者反映，在新建或迁移ASP.NET Core Web API项目后，尝试通过本地localhost地址访问时，浏览器显示“无法访问此网站”或“连接被拒绝”，导致开发调试流程受阻。该问题在Windows、macOS及Linux平台均有出现，已成为影响开发效率的常见痛点。本文结合社区反馈与官方文档，梳理了典型原因及修复方法。
现象：浏览器“拒绝连接”，项目启动无误
记者在模拟复现时发现，使用dotnet new webapi创建项目后，执行dotnet run正常显示“监听于 http://localhost:5000”，但打开浏览器输入该地址，页面长时间加载后提示“localhost 拒绝了我们的连接请求”。部分开发者还遇到端口被占用、防火墙弹窗警告或IIS Express绑定失败等情况。
原因分析：配置、环境与权限三大主因
经过对多起案例的追踪，技术社区总结出三个主要原因：
1. 项目启动配置与预期端口不匹配
ASP.NET Core默认在Properties/launchSettings.json中定义多个配置文件（如IIS Express、项目名称配置）。若开发者使用dotnet run启动，实际监听的端口取决于applicationUrl字段。常见错误是：launchSettings.json指定了非localhost的绑定（如*:5000或0.0.0.0:5000），但本地防火墙未开放相应端口；或者项目使用了HTTPS但证书未信任，导致浏览器直接拦截。
2. 端口被其他进程占用
Windows下可通过netstat -ano | findstr :5000检查端口占用。若发现进程PID，在任务管理器中终止即可。macOS/Linux可使用lsof -i :5000。记者实测，Visual Studio调试时若未完全关闭上次进程，常导致端口冲突。
3. 防火墙或代理干扰
企业环境或启用严格防火墙策略的机器，会阻断本地回环地址的入站连接。此外，系统代理（如VPN、Fiddler）有时会将localhost流量错误转发，造成连接失败。
解决方案：三步定位法
针对上述原因，开发者可按照以下步骤逐一排查：
第一步：验证监听地址
在项目根目录打开终端，运行dotnet run --urls "http://localhost:5000"，强制绑定到指定地址。若成功访问，说明launchSettings.json配置有误，应修改为"applicationUrl": "http://localhost:5000"。
第二步：检查端口与防火墙
确认端口未被占用后，临时关闭防火墙（Windows Defender或第三方软件）再试。若恢复正常，需在防火墙中添加“入站规则”允许http://localhost:5000的流量。注意：localhost的入站连接通常不需要外部端口开放，但部分安全软件会拦截本地回环。
第三步：清理运行时缓存
删除项目bin和obj目录，重新生成。同时关闭所有IDE（如VS、VS Code），用普通终端启动项目，排除IDE的附加代理（如IIS Express的HTTP.sys驱动）干扰。
专家建议：最佳实践避免重复踩坑
微软MVP、社区技术专家李维在受访时表示：“开发者应养成从命令行直接运行项目的习惯，而非过度依赖IDE。同时在Program.cs中使用app.Urls.Add("http://localhost:5000")显式绑定，比依赖launchSettings.json更可控。”他还推荐使用dotnet dev-certs https --trust修复HTTPS证书问题。
此外，对于需要跨网络访问的场景（如移动端测试），建议将端口绑定改为http://0.0.0.0:5000，并确保防火墙放行——但生产环境下务必限制为localhost。
结语
ASP.NET Core Web API本地访问异常虽令人困扰，但多数情况下通过检查配置、端口和防火墙即可解决。随着.NET 8/9的普及，微软已对默认模板进行了优化（如启动时自动检测端口冲突），但开发者仍需要掌握底层原理，才能从容应对复杂环境。若上述方法无效，建议在GitHub Issues或Stack Overflow上提供完整的dotnet run输出日志，以便社区协助定位。