如何通过GitLab API为GitLab Issues创建关联Tasks并避免无限循环

你当前的核心问题是误用了Issue API创建子Issue，导致触发webhook无限循环。GitLab中的Tasks属于Work Items体系，必须使用Work Items专属API来创建关联任务。

核心修改步骤 #

1. 替换API端点：将原有的Issue创建端点/api/v4/projects/$projectId/issues，替换为Work Items端点/api/v4/projects/$projectId/work_items
2. 指定Task类型：请求参数中必须添加work_item_type=task，明确要创建的是Task而非默认的Issue
3. 版本与权限检查：确保GitLab版本≥15.0（Task类型在该版本正式支持），且你的访问令牌拥有api权限范围

修正后的代码示例 #

// 遍历子任务并创建关联Task
foreach ( $subtasks as $subtask ) {
    try {
        // 通过GitLab Work Items API创建关联任务
        Http::withToken($gitlabAccessToken)->post("https://gitlab.com/api/v4/projects/$projectId/work_items", [
            'title' => $subtask['title'],
            'description' => $subtask['description'],
            'parent_id' => $issueId, // 关联到目标Issue的ID（Issue本身属于Work Item范畴）
            'work_item_type' => 'task' // 指定创建类型为Task
        ]);
    } catch ( \Exception $e ) {
        Log::error($e->getMessage());
        break;
    }
}

彻底解决无限循环问题 #

创建Work Item（Task）默认不会触发Issue相关的webhook事件，为了彻底避免循环，建议补充以下操作：

• 在GitLab项目的webhook配置中，仅勾选Issue事件下的created选项，不勾选Work Item相关事件
• 或者在你的API逻辑中，判断webhook的事件类型，只处理issue.created事件，忽略work_item.created事件

内容的提问来源于stack exchange，提问作者Kobus Beets