如何修复 Chrome 中的 ERR_BLOCKED_BY_CLIENT 错误

当你正在调试前端项目时,Chrome 的 DevTools 网络选项卡突然显示红色错误。错误信息显示 net::ERR_BLOCKED_BY_CLIENT。你的分析脚本无法加载,第三方字体静默失败,或者 API 请求始终无法完成。服务器并没有拒绝你的请求——是你自己机器上的某些东西阻止了它。

本指南将解释导致 ERR_BLOCKED_BY_CLIENT Chrome 错误的原因,并提供开发者诊断被阻止网络请求的实用故障排查步骤。

ERR_BLOCKED_BY_CLIENT 的实际含义

与服务器端错误(404、500)不同,这个 Chrome 请求被阻止错误源于本地。“客户端”指的是你的浏览器。Chrome 在告诉你:“我尝试获取这个资源,但设备上的某些东西阻止了我。”

请求从未到达服务器。相反,扩展程序、浏览器策略或本地配置在请求发出之前就拦截并取消了它。

这个区别很重要。你无法在服务器日志或网络基础设施中找到答案。解决方案存在于你的浏览器环境中。

开发者遇到的常见原因

浏览器扩展程序:主要罪魁祸首

具有网络过滤功能的扩展程序导致了大多数 ERR_BLOCKED_BY_CLIENT 错误。这些包括:

• 广告拦截器(uBlock Origin、AdGuard、AdBlock)
• 隐私工具(Privacy Badger、Ghostery)
• 安全扩展程序(脚本拦截器、反跟踪工具)

这些扩展程序维护过滤列表——匹配 URL 模式的规则。当请求 URL 触发过滤器时,扩展程序就会阻止它。对 analytics.example.com/track.js 的请求可能匹配针对跟踪脚本的过滤器,即使它对你的应用程序至关重要。

Manifest V3 和扩展程序变化

Chrome 向 Manifest V3 的转变改变了扩展程序拦截请求的方式。基于旧版 Manifest V2 架构构建的扩展程序可能表现不同,或者随着 Chrome 逐步淘汰支持而被完全禁用。如果你最近更新了 Chrome 并开始看到被阻止的请求,可能是过时的扩展程序失去功能——或者新更新的扩展程序改变了其阻止行为。

企业和托管浏览器策略

在企业环境中,IT 管理员部署限制网络访问的 Chrome 策略。这些策略可以在没有任何可见扩展程序的情况下阻止特定域名、资源类型或 URL 模式。

检查 chrome://policy 以查看活动策略。如果你使用的是托管设备,这通常是被忽视的 blocked-by-client 类型错误来源——即使没有安装扩展程序。

过滤列表误报

你的资源可能会无意中触发阻止。包含 /ads/、/tracking/ 或 /banner/ 等字符串的文件路径通常匹配过滤规则。位于 /assets/ads-campaign/hero.png 的合法图片可能仅因其路径而被阻止。

如何修复 ERR_BLOCKED_BY_CLIENT

步骤 1:在隐身模式下测试

打开隐身窗口(Windows 上按 Ctrl+Shift+N,Mac 上按 Cmd+Shift+N)。默认情况下,除非明确启用,否则扩展程序不会在隐身模式下运行。

如果请求在隐身模式下成功,则是扩展程序阻止了它。如果仍然失败,原因可能是浏览器策略或 Chrome 标志。

步骤 2:隔离阻止的扩展程序

要禁用扩展程序进行 Chrome 故障排查:

1. 导航到 chrome://extensions
2. 逐个关闭扩展程序
3. 每次更改后重新加载页面
4. 当请求成功时,你就找到了罪魁祸首

从广告拦截器和隐私工具开始——它们是最常见的问题源。

步骤 3:在 DevTools 中检查阻止情况

打开 DevTools(按 F12),转到网络选项卡并重新加载。失败的请求会在状态列中显示错误。点击请求查看详细信息。

某些扩展程序(如 uBlock Origin)会添加自己的 DevTools 面板,准确显示哪个过滤规则触发了阻止。这有助于你了解是否应该将域名加入白名单或重命名资源。

步骤 4:检查浏览器策略

访问 chrome://policy 查看任何活动限制。在托管设备上,像 URLBlocklist 这样的策略可以静默阻止请求。如果策略是问题所在,请联系你的 IT 管理员。

步骤 5:在全新配置文件中测试

创建一个没有扩展程序或自定义设置的全新 Chrome 配置文件:

1. 点击 Chrome 中的个人资料图标
2. 选择”添加”以创建新配置文件
3. 在这个干净的环境中测试你的应用程序

这可以同时消除缓存设置、损坏的数据和所有扩展程序。

步骤 6:检查资源命名

如果你控制被阻止的资源,请检查其 URL 路径。重命名包含常见过滤列表触发器(/ad/、/tracking/、/banner/、/sponsor/)的文件或目录。这可以防止用户浏览器中的误报。

当错误持续存在时

如果这些步骤都无法解决问题,请考虑:

• 在 chrome://flags 重置 Chrome 标志(点击”全部重置”)
• 清除浏览器缓存和 Cookie
• 检查杀毒软件是否包含网络过滤功能

结论

ERR_BLOCKED_BY_CLIENT 错误意味着你的浏览器——而不是服务器——正在阻止请求。扩展程序通常是罪魁祸首,但托管策略和过滤列表误报也会导致问题。使用隐身模式、扩展程序切换和全新配置文件进行系统性隔离将识别问题来源。对于开发者来说,理解这个错误可以避免在错误的地方花费数小时进行调试。

常见问题

Gain control over your UX

See how users are using your site as if you were sitting next to them, learn and iterate faster with OpenReplay. — the open-source session replay tool for developers. Self-host it in minutes, and have complete control over your customer data. Check our GitHub repo and join the thousands of developers in our community.