asynq.client 连不上 redis 主因是默认连接 localhost:6379 与生产环境（密码、非标端口、tls、docker 网络）不匹配，需显式配置 asynq.redisclientopt，包括 password 和 tlsconfig，并确保网络可达及队列名一致。
asynq.Client 为什么连不上 Redis？
默认配置下 asynq.NewClient 会尝试连接 localhost:6379，但多数生产环境 Redis 有密码、非默认端口或走 Unix socket。连不上时常见错误是 redis: nil 或 dial tcp [::1]:6379: connect: connection refused。
- 检查
asynq.RedisConnOpt是否传了正确地址：用asynq.RedisClientOpt{Addr: "10.0.1.5:6380", Password: "sekret"}，别漏掉Password字段（空密码也要显式写Password: ""） - 如果 Redis 启用了 TLS（比如云服务商托管版），必须用
asynq.RedisClientOpt{TLSConfig: &tls.Config{InsecureSkipVerify: true}}，否则静默失败 - Docker 或 Kubernetes 场景下，
localhost指向容器自身，不是宿主机 Redis —— 改用服务名如redis:6379，并确认网络策略放行
任务注册后不执行，asynq.Server 启动没反应？
asynq.ServeMux 必须显式注册处理器，且 asynq.Server 启动后不会自动拉取任务 —— 它只监听队列，等 Redis 里有任务才干活。没反应大概率是任务根本没进队，或队列名不匹配。
- 发任务时用的队列名（如
asynq.Enqueue(task, asynq.Queue("critical"))）必须和asynq.Server初始化时的asynq.ServerConfig{Queues: map[string]int{"critical": 10}}对得上，大小写敏感 - 别在
main()里直接server.Run()就结束 —— 它是阻塞调用，但如果你用go server.Run()又没加select{}或信号监听，主 goroutine 退出进程就死了 - 本地调试时加
asynq.WithLogLevel(asynq.DebugLevel)，看日志里有没有processing task或no tasks available这类线索
如何让 asynq 处理 panic 而不崩溃？
Handler 函数里 panic 会导致 worker goroutine 终止，但 asynq 默认会 recover 并把任务标记为 failed —— 这是设计行为，不是 bug。真正的问题是：你没配重试策略，或没处理 failed 任务。
- 用
asynq.Task{Type: "send_email", Payload: payload, MaxRetry: 3}控制重试次数，别依赖默认值（默认是 25，太激进） - panic 后任务进
asynq:failed集合，要用asynqadm工具或代码调client.RetryTask手动重试，它不会自动复活 - Handler 内部该加
defer清理资源（比如关闭 HTTP client 连接池），asynq 不管这个 —— panic 发生前的 defer 仍会执行
并发数设太高反而吞吐下降？
asynq.ServerConfig.Concurrency 不是核数越多越好。它控制每个队列的 worker goroutine 数量，但真实瓶颈常在 Redis 连接数、网络延迟或 Handler 里的 I/O 阻塞。
- 默认
Concurrency: 10对多数 HTTP/DB 场景已偏高；先从3~5开始压测，观察 Redis 的connected_clients和used_memory - 每个 worker 独占一个
redis.Conn，Concurrent=100 时 Redis 很可能报max number of clients reached—— 记得同步调大 Redis 的maxclients - Handler 里调外部 API 时，别用同步 HTTP client；用带超时的
http.DefaultClient或自定义&http.Client{Timeout: 5 * time.Second}，否则一个慢请求卡住整个 worker
asynq 的队列语义和重试逻辑很干净，但它的“透明性”恰恰是陷阱来源：Redis 状态、网络拓扑、Handler 内部阻塞点，三者任何一个出问题，表现都是任务卡住或丢失 —— 别只盯着 asynq 自己的配置看。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
