Asynq 启动时 Redis 连接失败会 panic，需手动预检（如 Ping）或封装重试逻辑；Handler 重复注册会 panic，应统一收口管理；默认重试 25 次，可通过 MaxRetry 或 SkipRetry 控制；本地开发可用 asynq.RedisInMemory 模拟，但不支持 Lua 脚本。
Asynq 服务端启动时连不上 Redis 怎么办
Asynq 默认启动时会立即尝试连接 Redis，如果连接失败（比如 Redis 地址错、密码没配、网络不通），asynq.NewServer 会直接 panic，而不是返回 error。这不是设计缺陷，而是它把连接可靠性交给了你——你得自己确保 Redis 可用，或在调用前做预检。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 启动前手动 ping 一次 Redis：
redisClient.Ping(ctx).Err()，失败则提前退出或重试 - 不要把
asynq.NewServer放在 main 函数开头就执行；把它包进一个带重试的初始化函数里 - 检查
asynq.RedisConnOpt中的Addr、Password、DB是否和你的 Redis 实例完全一致（例如：Sentinel 或 Cluster 模式需换用asynq.RedisClusterConnOpt） - 常见错误信息是
redis: can't marshal type xxx——这其实是用了不兼容的 redis 客户端（如 go-redis v9 的redis.UniversalClient），Asynq 目前只支持 v8 的*redis.Client或*redis.ClusterClient
注册 Handler 时 panic: “handler already registered”
Asynq 要求每个任务类型（type 字符串）只能注册一个 handler。如果你在多个包里都写了 asynq.HandleFunc("send_email", ...)，或者热重载时重复调用注册逻辑，就会触发这个 panic。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 所有
HandleFunc统一收口到一个task/handler.go文件里，用 switch 或 map 显式管理 - 避免在 HTTP handler 或 CLI 命令中动态注册；注册必须发生在 server 启动前，且仅一次
- 调试时加个 guard：
if asynq.IsHandlerRegistered("send_email") { log.Fatal("duplicate handler") }（注意：该函数非公开，实际要用私有字段反射判断，更稳妥的做法是自己维护一个map[string]bool） - 使用结构体 handler（实现
asynq.Handler接口）比闭包更可控，便于单元测试和依赖注入
任务执行失败后不重试，或无限重试停不下来
Asynq 默认对 panic 和未处理 error 都会重试，但重试次数和间隔由任务本身决定，不是全局配置。如果你没显式设置，它会用默认策略：最多 25 次，指数退避，最后一次失败后进 dead 队列。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 发任务时用
asynq.Task{Type: "send_email", Payload: payload}+client.Enqueue(task, asynq.MaxRetry(3))控制重试上限 - 在 handler 里主动返回
asynq.SkipRetry错误，可跳过后续重试（例如：用户邮箱格式明显非法，重试无意义） - 别在 handler 里 recover panic 后吞掉错误——Asynq 只认
error返回值，recover 后没 return error = 当作成功 - 用
asynq.Inspect("dead")查看死信任务，定期人工介入或写脚本清理，避免堆积
本地开发时想跳过 Redis，用内存模拟队列
Asynq 没有内置内存模式，强行 mock Redis 容易漏掉序列化、并发、超时等真实行为。但你可以用 asynq.RedisInMemory ——这是社区维护的轻量替代实现，兼容 Asynq v0.30+ 的 wire 协议。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 开发环境改用：
asynq.NewRedisClient(asynq.RedisInMemory())，server/client 初始化方式不变 - 注意它不支持 Lua 脚本，所以某些高级功能（如优先级队列原子操作）可能降级，但普通任务 enque/dequeue 是 OK 的
- CI 或测试中慎用：内存实例无法跨进程共享，
go test -race下多 goroutine 并发 enqueue 可能出竞态，建议单测仍走真实 Redis 容器（docker-compose up redis） - 别在生产配置里留
if env == "dev"切换 client，容易误发布；用构建 tag 或配置中心隔离
