错误码与错误信息
⚠️ snir 常见错误及排查指引。
snir 是 CLI 工具，退出码非零表示失败。本页罗列常见错误信息与建议处理。
退出码
| 退出码 | 含义 |
|---|---|
0 | 成功 |
非 0 | 执行出错（具体原因见 stderr） |
常见错误信息
Could not find node with given id
无法找到页面上的某个元素原因：页面元素在截图/选择器定位时不存在。
建议：
- 网站加载较慢 → 增加超时
--timeout 60 - 网站反爬虫
- 网站结构与预期不符
- 增加延迟
--delay 3
timeout / 扫描超时
扫描超时: 无法在指定时间内完成页面加载建议：
- 增加超时
--timeout 60 - 检查网络连接
- 检查目标站点是否可访问
net::ERR_*
网络错误: 无法连接到目标网站常见 net::ERR_CONNECTION_REFUSED、ERR_NAME_NOT_RESOLVED、ERR_TIMED_OUT。
建议：检查目标可达性、DNS、代理配置。
Chrome 未找到
ChromeNotFoundError建议：
- 安装 Chrome/Chromium
- 指定路径
--chrome-path /usr/bin/chromium - 用远程 Chrome
--wss ws://...
证书错误
--ignore-cert-errors 仅限测试
--ignore-cert-errors 让 snir 接受任意伪造证书，无法识别中间人攻击。
- ✅ 仅用于测试自签名证书的内网环境
- ❌ 生产环境切勿使用，否则等于关掉 HTTPS 的安全保障
排查流程
常见错误按来源归类，便于快速定位：
调试日志
加 -D 启用调试日志，输出详细 CDP 交互过程：
bash
snir scan example.com -D