hs-video-api/QUEUE_CONFIG_README.md

队列管理配置说明

本文档说明了视频生成API服务中队列管理相关的配置参数。

配置参数

基础队列配置

参数名	环境变量	默认值	说明
最大运行任务数	QUEUE_MAX_RUNNING_TASKS	5	同时运行的最大任务数量
状态更新间隔	QUEUE_UPDATE_INTERVAL	5	任务状态检查更新间隔（秒）
持久化文件	QUEUE_PERSISTENCE_FILE	task_queue_persistence.json	队列数据持久化文件路径

缓存管理配置

参数名	环境变量	默认值	说明
已完成任务缓存大小	QUEUE_MAX_COMPLETED_CACHE_SIZE	100	最多保留的已完成任务数量
缓存保留时间	QUEUE_COMPLETED_CACHE_TTL_HOURS	24	已完成任务在缓存中保留的小时数

环境配置建议

开发环境 (.env.dev)

# 队列管理配置
QUEUE_MAX_RUNNING_TASKS=5
QUEUE_UPDATE_INTERVAL=5
QUEUE_PERSISTENCE_FILE=task_queue_persistence.json
QUEUE_MAX_COMPLETED_CACHE_SIZE=100
QUEUE_COMPLETED_CACHE_TTL_HOURS=24

测试环境 (.env.dev-server)

# 队列管理配置
QUEUE_MAX_RUNNING_TASKS=8
QUEUE_UPDATE_INTERVAL=3
QUEUE_PERSISTENCE_FILE=task_queue_persistence.json
QUEUE_MAX_COMPLETED_CACHE_SIZE=200
QUEUE_COMPLETED_CACHE_TTL_HOURS=24

生产环境 (.env.pro)

# 队列管理配置
QUEUE_MAX_RUNNING_TASKS=10
QUEUE_UPDATE_INTERVAL=3
QUEUE_PERSISTENCE_FILE=task_queue_persistence.json
QUEUE_MAX_COMPLETED_CACHE_SIZE=500
QUEUE_COMPLETED_CACHE_TTL_HOURS=48

配置调优建议

QUEUE_MAX_RUNNING_TASKS（最大运行任务数）

• 开发环境: 5个任务，适合本地开发测试
• 测试环境: 8个任务，模拟中等负载
• 生产环境: 10个任务，根据服务器性能和API限制调整

QUEUE_UPDATE_INTERVAL（状态更新间隔）

• 开发环境: 5秒，便于调试观察
• 测试/生产环境: 3秒，提高响应速度
• 注意: 间隔太短会增加API调用频率，太长会影响用户体验

QUEUE_MAX_COMPLETED_CACHE_SIZE（缓存大小）

• 开发环境: 100个任务，满足基本需求
• 测试环境: 200个任务，支持更多测试场景
• 生产环境: 500个任务，支持高并发场景

QUEUE_COMPLETED_CACHE_TTL_HOURS（缓存保留时间）

• 开发/测试环境: 24小时，便于调试和测试
• 生产环境: 48小时，给用户更长的查询窗口

性能影响

1. QUEUE_MAX_RUNNING_TASKS: 影响并发处理能力和资源消耗
2. QUEUE_UPDATE_INTERVAL: 影响状态更新及时性和API调用频率
3. QUEUE_MAX_COMPLETED_CACHE_SIZE: 影响内存使用和查询性能
4. QUEUE_COMPLETED_CACHE_TTL_HOURS: 影响存储空间和数据一致性

监控建议

建议监控以下指标：

• 运行中任务数量
• 等待队列长度
• 任务完成率
• 平均处理时间
• 缓存命中率

通过这些指标可以判断当前配置是否合适，并进行相应调整。