Gotenberg项目中Chromium连接拒绝错误的处理优化

在文档转换服务Gotenberg的最新更新中，开发团队针对Chromium引擎在处理不可达URL时的问题进行了重要改进。当用户请求转换一个无法访问的网页时，Chromium会抛出net::ERR_CONNECTION_REFUSED错误，而原先的系统并未对此类错误进行适当处理。

问题背景 在文档转换场景中，Gotenberg使用Chromium作为渲染引擎来加载网页内容。当目标URL对应的服务器拒绝连接时，Chromium会在内部生成ERR_CONNECTION_REFUSED错误。这类错误表明目标服务器明确拒绝了连接请求，而非简单的资源不存在。

技术实现 开发团队通过监听Chromium的Network.loadingFailed事件来捕获这类连接错误。当检测到错误类型为net::ERR_CONNECTION_REFUSED时，系统现在会主动中断转换流程，并向客户端返回400 Bad Request状态码。选择400而非404的原因是：

1. 连接被拒绝意味着服务器存在但拒绝服务，不同于资源不存在的情况
2. 更准确地反映问题的本质，帮助开发者进行问题诊断

相关考量 值得注意的是，这个改进目前仅针对主文档加载失败的情况。对于网页中引用的外部资源（如CSS、JS文件）加载失败的情况，系统仍保持原有行为。这种设计决策基于以下考虑：

1. 网页可能设计为降级显示，缺少某些资源仍可正常渲染
2. 全面监控所有资源加载会显著增加系统复杂性
3. 不同资源加载失败可能产生多种错误类型，维护成本较高

最佳实践建议 对于使用Gotenberg的开发人员，建议：

1. 在调用API前验证目标URL的可访问性
2. 实现适当的错误处理逻辑，特别是对400状态码的处理
3. 对于关键资源，考虑预先下载并作为附加文件提交

这个改进已在Gotenberg的最新edge版本中部署，显著提升了系统对异常情况的处理能力，使错误反馈更加准确和有意义。