GoFlow应作为独立sidecar服务运行，不可嵌入HTTP handler；需显式指定Redis DB索引隔离状态；节点函数须依赖注入而非全局变量；重试策略应按节点粒度关闭并由业务自主控制。
直接用 goflow.FlowService 启动一个独立工作流服务，别试图把它塞进已有 HTTP handler 里
GoFlow 不是中间件，也不是一个可嵌入的库函数。它自带运行时、状态管理、Redis 连接池和 HTTP 服务监听逻辑。强行在 Gin/echo 的 HandlerFunc 里调用 fs.Start() 会导致 panic：端口被重复绑定、goroutine 泄漏、context 冲突。实际部署中，应将 GoFlow 视为一个协程密集型的 sidecar 服务，与主微服务进程分离。
- 正确做法：启动一个单独的
cmd/flow-service/main.go，只负责加载工作流定义、连接 Redis、暴露/v1/flows等管理接口 - 主微服务通过 HTTP client（带 timeout）调用该 sidecar 的 API 触发流程，例如
POST http://flow-svc:8080/v1/flows/myflow/instances - 若必须共进程，至少用
go fs.Start()异步启动，并确保fs.Port不与主服务冲突（比如设为8081）
flow.Workflow 定义里不能直接引用微服务的全局变量或 DB 连接
GoFlow 的每个工作流节点（dag.Node）在运行时由独立 goroutine 执行，且可能被调度到任意 worker 实例上。若你在 doSomething 函数里直接用了 db *sql.DB 或 cfg *Config 这类包级变量，会触发竞态或 nil panic——因为 GoFlow 并不保证节点执行时这些变量已初始化，也不跨实例共享内存。
- 解决方案：把依赖注入到
context.Context中，或通过flow.Context的Set/Get方法传递 - 示例：在
DefineWorkflow中，用context.WithValue(ctx, "db", db)包装后传入节点；节点函数签名保持func(data []byte, option map[string][]string) ([]byte, error)，内部从context提取 - 更推荐：用工厂函数封装节点，闭包捕获所需依赖，如
func(db *sql.DB) flow.NodeFunc { return func(...) {...} }
Redis URL 配置必须显式指定 DB index，否则多个微服务会互相污染状态
GoFlow 默认使用 Redis DB 0 存储流程实例、任务状态和重试队列。如果你的微服务集群里有订单流、风控流、通知流三个服务都用默认配置，它们会往同一个 DB 写 key，导致 instance:abc123 被覆盖、任务丢失、状态错乱——错误信息通常是 redis: nil reply 或 workflow not found。
- 务必在
goflow.FlowService初始化时指定 DB：RedisURL: "redis://localhost:6379/1"（订单流用 DB 1）、"redis://localhost:6379/2"（风控流用 DB 2） - 不要依赖环境变量自动 fallback；GoFlow 不解析
REDIS_URL，必须硬编码或显式读取配置项 - 生产环境建议为每个业务域申请独立 Redis 实例，而非仅靠 DB 分隔
节点函数返回 error 时，GoFlow 默认重试 3 次并暂停整个 DAG，这在微服务场景下往往不合适
微服务间调用天然不稳定（网络抖动、下游超时），但 GoFlow 的默认重试策略会把一次临时失败放大成流程卡死。比如 node2 调用支付网关超时，GoFlow 会阻塞后续所有节点，等 3 次重试耗尽才标记失败——此时上游可能已重发请求，造成重复执行。
立即学习“go语言免费学习笔记（深入）”；
- 关闭自动重试：在
dag.Node注册时传入选项flow.WithMaxRetries(0) - 改由节点自身处理容错：在
doSomething内部用http.Client+ctx.WithTimeout控制单次调用，并根据 error 类型决定是返回nil, err（让 GoFlow 标记失败）还是data, nil（降级处理） - 注意：
flow.WithMaxRetries是 per-node 的，不是全局开关；每个节点需单独设置
真正难的不是写几个 dag.Node，而是让 GoFlow 的状态机行为与你微服务的 SLA 对齐——比如“支付回调必须 5 秒内响应”，这就要求你主动控制超时、重试、降级点，而不是依赖框架默认值。
