ReactJS部署GitHub Pages报net::ERR_BLOCKED_BY_CLIENT错误咨询

net::ERR_BLOCKED_BY_CLIENT 错误和GitHub Pages部署配置、React代码逻辑没有直接关系，错误本身的含义是请求被访问者本地的客户端程序拦截，结合你API接口全部正常的现象，常见触发场景如下：

• 占比90%以上的诱因是浏览器安装的广告拦截类扩展（AdBlock、uBlock Origin、AdGuard等），扩展内置的拦截规则匹配到你页面加载的某一项资源路径、文件名包含广告/追踪相关关键词（比如路径含/ad/、/track/、analytics，文件名带banner、promo等），就会直接阻断请求。
• 其次是浏览器自带的安全防护功能，比如Chrome安全浏览、Edge严格模式跟踪防护、Firefox内容拦截功能，会对判定为追踪器、广告资源的请求做拦截。
• 少数情况是本地杀毒软件、系统防火墙的网页防护模块，在网络层拦截了对应资源请求。

这类拦截一般只会命中静态资源（打包后的js分片、图片、字体文件、第三方埋点脚本等），不会影响业务API接口请求，和你描述的现象完全吻合。

• 第一步先定位被拦截的具体资源：打开浏览器开发者工具切换到Network面板，刷新页面后筛选状态为blocked的请求，记录下被拦截资源的路径、文件名。
• 第二步调整资源命名/路径：如果是你自己项目内的资源命中了拦截关键词，直接修改文件名、调整资源存放路径，避开拦截规则匹配的敏感词即可，比如把ad-tag.js重命名为业务相关的product-tag.js，重新打包部署后就不会被误拦。如果是你主动引入的第三方广告、埋点脚本被拦截，要么移除相关脚本，要么把脚本内容存到自己项目仓库里本地化加载，不要直接调用第三方广告域名下的资源。
• 第三步做本地校验：排查时临时禁用所有浏览器扩展，或者打开浏览器无痕模式（默认不会加载第三方扩展）访问部署后的页面，如果报错消失，就可以完全排除部署故障，确认是客户端拦截规则导致的问题。
• 如果被拦截的是GitHub Pages平台自带的访问统计脚本，不需要额外处理，这类拦截不会影响应用核心功能，安装广告拦截插件的用户本身也对这类资源拦截有预期，不会影响正常使用。

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