Studio 上线检查与排障路径
本文面向已经在 Studio 中完成任务开发、准备上线或刚刚开始运行链路的用户，帮助你在两个关键阶段少走弯路：上线前，先把最值得检查的事项看清楚；出现异常时，先沿着一条更稳定的排查路径往下看。
这篇文档不替代具体功能文档，而是把 Studio 中分散在不同模块里的检查点和排障入口串成一条更接近日常工作的路径。
什么时候适合先看这篇
任务草稿已经写好准备配置调度和发布、组合任务已经创建准备确认 DAG 是否完整、同步任务已经建好准备观察是否会稳定运行、任务已经发布但想先做一次上线前复核、任务运行结果不符合预期想先知道从哪里排查，这几个场景都比较适合先看这篇。
上线前，建议先确认五件事
对象是不是在正确的位置。 先确认当前工作区是否正确、任务是否在正确目录下、是否误把测试对象放进了正式目录、是否存在同名对象容易混淆。这一步看起来简单，但往往能帮你很早发现问题。对象本身就在错误的工作区或目录里，后面的调度、发布、监控判断都会变得不稳定。
当前处于哪个阶段。 上线前最好先确认当前对象到底处在哪一层：只是草稿、草稿和内容都已保存、调度配置已经保存、已经发布、还是已经产生运行实例。很多误会都来自这几层混在一起理解——看到任务对象不代表已经运行，保存了 Cron 不代表已经发布，发布了任务不代表已经有运行实例。
内容和配置是不是都补齐了。 不同对象关注点不同，但一般都建议至少确认任务内容是否已保存、参数是否完整、VCluster 是否正确、调度时间是否符合预期、失败重试和超时是否合理、是否存在上下游依赖。如果是组合任务，还建议额外确认子任务节点是否都存在、节点内容是否已补齐、依赖边是否存在、DAG 是否为空。
这次变更会不会影响别的对象。 上线前，建议先判断变更影响范围，包括会不会写入或覆盖数据、会不会影响上游或下游任务、会不会影响已有调度链路、会不会和现有规则或实例发生冲突。这一步尤其适合在发布、修改依赖、补数、删除或取消发布前先做。
运行后你准备用什么来验证。 在真正上线前，最好先想清楚上线后先看哪个监控入口、如果没有实例怎么解释、如果失败先看日志还是先看配置、如果是同步任务先看链路状态还是目标表结果。很多排障效率的差异，不在于问题本身，而在于上线前有没有先准备好验证路径。
Studio 级上线前检查清单
通用检查：工作区正确、目录正确、对象名称或 ID 明确、测试对象与正式对象没有混用。
任务对象检查：内容已保存、参数已确认、集群已确认、调度配置已确认。
组合任务检查：组合任务对象存在、节点数量符合预期、子任务内容已补齐、DAG 依赖边存在。
治理对象检查：DQC 规则对象存在、规则类型和检查对象正确、触发方式理解清楚。
发布前检查：当前是否真的需要发布、发布后预期状态是什么、如果出问题如何回退或取消后续自动运行。
出问题时，建议先按这条路径排查
Studio 中很多异常，其实都可以先沿着同一条路径看，而不必一开始就在很多页面之间来回切换。
第一步：先确认对象状态。 先问清楚对象还在不在、在哪个工作区、在哪个目录、当前是草稿、已配置还是已发布。如果这里还没确认清楚，后面看到的监控或运行结果就很容易解释偏。
第二步：再确认有没有运行实例。 如果当前问题和"为什么没跑""为什么没有结果"有关，通常先查最近 24 小时有没有实例，没有的话再查最近 30 天，再判断监控为空是正常空态还是需要进一步排查。对新空间、测试空间、未发布任务来说，空态通常并不罕见。
第三步：有实例时，再看日志和错误摘要。 如果已经有运行实例，通常下一步更值得看运行状态、错误摘要、开始结束时间、日志入口、是否有重跑或补数入口。这一步的目标不是一次性解释所有问题，而是先把"失败发生在什么阶段"看清楚。
第四步：再回查配置与依赖。 很多实例异常，最后都会回到配置或依赖。建议重点回看 Cron 是否正确、集群是否正确、重试和超时是否合理、参数是否完整、依赖关系是否正确、组合任务 DAG 是否完整。如果是同步任务，则进一步关注数据源状态、同步方式是否选对、目标表或目标链路是否按预期落地。
几类高频问题，适合先怎么查
任务明明创建了，为什么没有运行： 先看当前只是草稿还是已经发布，再看是否已保存调度配置，再看当前时间范围内是否有实例，最后判断监控为空是否属于正常空态。
组合任务已经创建，为什么结果还是不对： 先看组合任务对象是否存在，再看 DAG 是否为空，再看节点内容是否都补齐，最后看依赖边是否存在。
规则已经建了，为什么还没看到结果： 先区分现在看到的是规则对象还是已经有规则执行结果，再确认当前触发方式是什么。
监控页为空，应该怎么理解： 先判断当前是不是新空间或测试空间，再确认当前对象是否从未发布或从未运行，再看最近 24 小时和 30 天是否都为空。
让 Agent 帮你上线和排障时，更稳妥的说法
上线前检查：
组合任务复核：
运行异常排查：
高影响操作前先看影响范围：