Blocky项目中HTTP请求超时问题的分析与解决

问题背景

在Blocky这一DNS代理和广告拦截工具的实际部署中，用户反馈在Web界面执行"列表刷新"操作时会出现"CORS或网络问题"的错误提示。经过深入分析，发现这一问题与HTTP请求超时机制密切相关。

问题现象

用户在使用Blocky的Web管理界面时，当触发黑名单列表刷新操作时，浏览器控制台会显示"CORS或网络问题"的错误信息。值得注意的是，其他所有API请求都能正常工作，唯独列表刷新操作会出现异常。

环境特点

用户部署环境具有以下特点：

1. 运行在OpenWRT系统的Nokia路由器上
2. 使用LXC容器部署Blocky服务
3. 系统内存资源有限（仅120MB）
4. 列表刷新操作耗时较长（超过20秒）

根本原因分析

经过技术排查，发现问题根源在于Blocky服务端的HTTP写超时设置。当前代码中硬编码了一个20秒的写超时限制（writeTimeout），而用户的低配置环境在执行资源密集型操作（如列表刷新）时，处理时间超过了这一阈值，导致连接被强制关闭。

解决方案

为解决这一问题，技术团队提出了以下改进方案：

1. 将硬编码超时改为可配置参数：将原先固定的20秒超时设置改为可通过配置文件调整的参数
2. 保持向后兼容：默认值仍设置为20秒，不影响现有部署
3. 文档完善：在配置说明文档中明确新增参数的用途和推荐值

配置建议

对于资源受限环境，建议在配置文件中增加如下参数：

server:
  writeTimeout: 600s

这一调整允许处理时间较长的操作能够顺利完成，而不会因超时被中断。

技术启示

这一案例揭示了在开发系统服务时需要重点考虑的几个方面：

1. 环境差异性：开发环境与生产环境在资源配置上可能存在巨大差异
2. 超时机制设计：对于耗时操作，应提供足够的灵活性
3. 资源密集型操作：内存、CPU等资源限制会显著影响操作执行时间

通过这一改进，Blocky项目能够更好地适应各种硬件环境，特别是资源受限的嵌入式设备场景，提升了软件的兼容性和用户体验。