Azure DevOps Pipeline执行超时、SQL异常未捕获问题咨询

当前Azure DevOps Pipeline运行涉及两项长耗时操作：

• SQL存储过程调用，实际执行时长约10小时
• 存储过程执行完成后触发数据库备份，耗时约12小时
  管道运行满6小时固定抛出报错：

Not received any response, or we stopped hearing from Agent Azure Pipelines 4. Verify the agent machine is running and has a healthy network connection. Anything that terminates an agent process, starves it for CPU, or blocks its network access can cause this error. For more information
已排查确认网络连接正常、存储过程本身无运行故障，已尝试配置timeout to 0 & 7600、timeout to 7600、Number of retries if task fail to 5，问题仍未解决。
待解决的两个核心问题：

1. 如何配置Pipeline，使其等待SQL存储过程完全执行完成，不会提前中断
2. 如何捕获SQL执行异常并终止管道，解决当前SQL执行出错时管道仍标记为成功的问题

长耗时任务6小时自动中断问题修复 #

Azure DevOps Pipeline超时为多层级控制，仅修改单任务超时不生效是因为上层配置未同步调整，按以下优先级逐一配置：

• 调整Agent池超时配置：进入任务使用的Agent池设置页，找到Agent作业超时选项，默认值为360分钟（即6小时），修改为0（无超时限制），或设置为大于总任务时长的值，比如1500分钟（覆盖10小时存储过程+12小时备份的总耗时）
• 配置Pipeline作业级超时：在管道定义的job层级添加timeoutInMinutes: 0，该配置优先级高于Agent池默认配置，同时单步骤任务也同步配置该参数，YAML示例：

jobs:
- job: LongTimeSQLTask
  timeoutInMinutes: 0 # 作业维度无超时限制
  pool: your-target-agent-pool
  steps:
  - task: SqlAzureDacpacDeployment@1 # 替换为实际使用的SQL执行任务
    timeoutInMinutes: 0 # 单任务维度无超时限制
    inputs:
      # 填入实际的SQL连接、存储过程调用参数

• 稳定性优化：不要用单长连接同步等待存储过程执行，改用异步触发+轮询模式，彻底规避Agent长时间无心跳触发的断连判断：
  • 第一步通过SQL命令异步启动存储过程，不等待执行返回，拿到对应作业执行ID
  • 第二步新增轮询步骤，每隔3-5分钟查询一次存储过程执行状态，每次轮询为短连接请求，不会触发超时
  • 轮询到执行成功则进入备份步骤，轮询到执行失败则直接抛出错误终止管道

SQL执行异常捕获与管道失败标记配置 #

默认SQL执行任务多数场景下无法识别存储过程抛出的业务错误，导致任务误标记为成功，按以下步骤配置：

• 存储过程头部添加配置：在存储过程最开头添加SET NOCOUNT ON; SET XACT_ABORT ON;，确保SQL遇到运行错误时会返回非0退出码
• 存储过程内部增加异常捕获逻辑，错误时主动抛出级别16及以上的错误（只有级别>=16的错误会被SQL客户端识别为执行失败），示例结构：

CREATE PROCEDURE YourLongRunningSP
AS
BEGIN
    SET NOCOUNT ON;
    SET XACT_ABORT ON;
    BEGIN TRY
        -- 原有存储过程业务逻辑
    END TRY
    BEGIN CATCH
        DECLARE @ErrMsg NVARCHAR(4000) = ERROR_MESSAGE(),
                @ErrSeverity INT = ERROR_SEVERITY(),
                @ErrState INT = ERROR_STATE();
        RAISERROR(@ErrMsg, @ErrSeverity, @ErrState);
    END CATCH
END

• SQL执行任务开启错误校验：如果使用可视化任务配置，勾选「存在SQL错误时标记任务失败」选项；如果使用YAML配置，给任务添加failOnStandardError: true参数
• 如果通过PowerShell/CMD脚本调用sqlcmd执行存储过程，脚本内必须增加退出码判断，非0状态下主动返回退出码1，让管道识别任务失败，PowerShell示例：

sqlcmd -S <数据库地址> -d <数据库名> -U <用户名> -P <密码> -Q "EXEC YourLongRunningSP"
if ($LASTEXITCODE -ne 0) {
    Write-Error "存储过程执行失败，退出码：$LASTEXITCODE"
    exit 1
}

内容的提问来源于stack exchange，提问作者kumar ram