XL-Release中Python脚本任务索引越界错误求助

错误原因 #

你遇到的Task index out of bounds错误，核心问题是调用phaseApi.addTask时传入的position参数超出了当前阶段的合法任务索引范围。XL-Release中，阶段的任务插入位置position合法取值为1到当前阶段任务总数+1，如果遍历字典列表时position值未动态更新（比如始终用固定值），或初始值设置过大，就会触发索引越界检查。

修复方案 #

方案1：自动将任务添加到阶段末尾（推荐） #

若无需指定任务插入位置，直接省略position参数，让XL-Release自动把任务添加到阶段最后，彻底避免位置索引问题：

def addTaskToChangeVariable(value):
    scriptTask = taskApi.newTask("xlrelease.ScriptTask")
    print("The task is {} ".format(scriptTask))
    # 用repr(value)确保字典格式被正确转义，避免脚本语法错误
    scriptTask.script = "releaseVariables.update({})".format(repr(value))
    scriptTask.title = "{} ".format(value)
    # 移除position参数，默认添加到阶段末尾
    scriptTask = phaseApi.addTask(task.container.id, scriptTask)
    # taskApi.lockTask(scriptTask.id)

方案2：动态更新position值 #

若需指定任务插入顺序，确保每次添加任务后position值递增，保证始终在合法范围内：

# 外部循环初始化position
position = 1

def addTaskToChangeVariable(value):
    global position  # 嵌套函数中可改用nonlocal
    scriptTask = taskApi.newTask("xlrelease.ScriptTask")
    print("The task is {} ".format(scriptTask))
    scriptTask.script = "releaseVariables.update({})".format(repr(value))
    scriptTask.title = "{} ".format(value)
    scriptTask = phaseApi.addTask(task.container.id, scriptTask, position)
    position += 1  # 每次添加后递增position
    # taskApi.lockTask(scriptTask.id)

额外排查点 #

1. 检查position初始值：若初始值大于当前阶段任务总数+1，第一次添加就会报错。可先通过phaseApi.getTasks(task.container.id)获取当前任务列表，确认总数后再设置初始position。
2. 确认遍历逻辑：如果是并行遍历（如多线程），可能导致position被并发修改引发索引冲突，这种情况建议用方案1或加锁处理。

内容的提问来源于stack exchange，提问作者Code Klaudia