如何通过GitLab API利用旧路径获取已迁移项目的新路径？

当GitLab项目迁移后，网页访问旧URL会自动重定向，但API直接请求旧路径会返回404。要仅通过旧路径拿到新路径，有以下几种可行方法：

1. 追踪HTTP重定向（模拟网页跳转逻辑） #

GitLab对旧项目网页的重定向逻辑同样适用于API请求，只是默认API客户端不会自动跟随重定向。你可以手动发送请求并检查响应头：

• 构造旧项目的API请求地址，比如GET /api/v4/projects/old%2Fnamespace%2Fproject（注意路径里的斜杠要转成%2F）
• 发送请求后，如果项目已迁移，会收到302 Found响应，响应头里的Location字段就是新项目的API地址
• 解析Location字段，解码后就能得到新的path_with_namespace

示例curl命令（需替换令牌和GitLab地址）：

curl -v --header "PRIVATE-TOKEN: <你的令牌>" "https://gitlab.example.com/api/v4/projects/old%2Fproject"

在输出里找Location头，比如Location: /api/v4/projects/new%2Fproject，解码后就是new/project。

2. 用旧路径搜索项目 #

直接通过API的搜索功能，用旧路径作为关键词查找对应项目：

curl --header "PRIVATE-TOKEN: <你的令牌>" "https://gitlab.example.com/api/v4/projects?search=old%2Fproject"

返回的结果中，找到目标项目（可以通过项目描述或迁移相关备注辅助判断），从path_with_namespace或web_url字段提取新路径。如果项目迁移后保留了旧路径的关联，这个方法大概率能命中。

3. 管理员权限下查导入记录（如果适用） #

如果你有GitLab管理员权限，可以通过导入状态筛选项目，结合旧路径搜索：

curl --header "PRIVATE-TOKEN: <你的令牌>" "https://gitlab.example.com/api/v4/projects?import_status=finished&search=old%2Fproject"

迁移后的项目会有导入记录，通过这个接口能快速定位到对应的新项目，直接获取新路径。

关键注意点 #

• 必须确保API令牌拥有read_api权限，否则会返回权限错误
• 路径中的斜杠一定要URL编码，否则API会把斜杠当成路径分隔符，导致请求地址错误
• 如果旧项目是被删除而非迁移，以上方法都无效，工具里要加对应的错误处理逻辑，提示用户手动更新路径

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