Puppeteer网页爬虫报错解析及官方错误列表查询请求

目前Puppeteer官方并没有像Node.js那样专门的集中式错误列表页面，它的错误相关信息大多分散在官方文档的API说明、使用指南，以及GitHub仓库的issue和社区讨论中。

针对你爬取1500个网页时遇到的各类错误，按类型整理成因及解决思路如下：

网络连接类错误 #

• ERR_NAME_NOT_RESOLVED：域名无法被DNS解析，可能是域名不存在、DNS配置异常，或是网络环境限制了域名访问。解决思路：确认目标域名正确性，切换公共DNS服务器，检查网络是否能正常访问该域名。
• Navigation timeout of 30000 ms exceeded：页面导航超时，多因页面资源加载过慢、请求阻塞导致。解决思路：延长导航超时时间（示例：page.goto(url, {timeout: 60000})），禁用非必要资源加载（如图片、样式表）以加快页面加载速度。
• ERR_TIMED_OUT：请求超时，服务器响应延迟过高或网络不稳定。解决思路：增加请求重试机制，延长超时阈值，优化网络环境。
• ERR_CONNECTION_RESET：连接被服务器主动重置，或网络波动导致连接中断。解决思路：添加重试逻辑，检查目标服务器是否正常运行。
• ERR_CONNECTION_REFUSED：目标服务器拒绝连接，可能是服务器未监听指定端口、防火墙拦截请求。解决思路：确认服务器地址和端口的正确性，检查本地或服务器端防火墙规则。
• ERR_CONNECTION_CLOSED：连接提前关闭，多因服务器异常或网络中断。解决思路：添加重试请求逻辑，排查网络稳定性。
• ERR_EMPTY_RESPONSE：服务器返回空响应，可能是服务器内部错误、请求被拦截。解决思路：检查请求参数合法性，重试请求，排查目标服务器状态。

SSL证书类错误 #

• ERR_CERT_AUTHORITY_INVALID：证书颁发机构不被信任，常见于自签名证书或证书链不完整的情况。解决思路：测试环境下可启动浏览器时添加--ignore-certificate-errors参数忽略证书验证（生产环境不建议使用）。
• ERR_CERT_COMMON_NAME_INVALID：证书绑定的域名与请求域名不匹配。解决思路：确认请求域名与证书匹配，测试环境下可忽略证书错误。
• ERR_CERT_DATE_INVALID：证书超出有效期（已过期或未生效）。解决思路：检查证书有效期，测试环境下可忽略证书错误。
• ERR_SSL_PROTOCOL_ERROR：SSL协议版本不兼容，服务器与浏览器使用的SSL协议无法匹配。解决思路：指定浏览器兼容的SSL协议版本，或在测试环境忽略证书错误。
• ERR_SSL_VERSION_OR_CIPHER_MISMATCH：SSL加密套件不匹配，服务器与浏览器协商的加密方式不一致。解决思路：调整浏览器SSL配置，使用兼容的加密套件，测试环境下可忽略证书错误。

页面导航与执行上下文类错误 #

• ERR_ABORTED：请求被中止，可能是页面自动跳转、资源加载被取消或浏览器主动中断请求。解决思路：检查页面是否存在自动跳转逻辑，调整请求触发时机。
• Execution context was destroyed, most likely because of a navigation：执行上下文被销毁，通常是页面导航导致之前的DOM上下文失效。解决思路：等待页面导航完成后重新获取执行上下文，避免在导航过程中执行DOM操作。
• ERR_TOO_MANY_REDIRECTS：页面陷入无限重定向循环。解决思路：设置重定向限制（示例：page.goto(url, {followRedirects: false})），排查目标页面的重定向逻辑。
• ERR_INVALID_RESPONSE：服务器返回的响应不符合HTTP规范。解决思路：检查服务器返回内容，重试请求。

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