Satis+GitLab私有项目构建后无可用包问题求助

针对你的Satis构建GitLab Pages仓库为空、无dist文件夹的问题，按以下步骤排查：

1. 确认GitLab权限与包可见性 #

• 检查Personal Access Token（PAT）权限：必须包含read_api和read_repository，否则无法拉取私有包元数据。
• 验证包的访问权限：确保PAT所属账号能访问目标私有包的项目，且包的可见性设置（项目/组级别）允许该账号读取。

2. 修改Satis仓库配置类型 #

GitLab私有Composer包注册表需要使用gitlab类型仓库，而非默认的composer类型，否则无法正确解析私有包元数据。修改satis.json：

{
    "repositories": [
        {
            "type": "gitlab",
            "url": "https://gitlab.com/api/v4/group/<group-id>/-/packages/composer/",
            "options": {
                "gitlab-token": "${PERSONAL_ACCESS_TOKEN}"
            }
        }
    ],
    "require-all": true,
    "archive": {
        "directory": "dist",
        "format": "zip",
        "skip-dev": true
    }
}

3. 开启构建详细日志 #

在.gitlab-ci.yml的构建命令中添加详细日志参数，排查静默错误：

script:
  - composer satis:build satis.json ./public -v

查看日志中是否存在“无法获取包元数据”“无匹配包”等提示。

4. 验证组包注册表的元数据 #

本地用curl测试组包注册表的返回内容，确认是否有包数据：

curl --header "Private-Token: YOUR_PAT" https://gitlab.com/api/v4/group/<group-id>/-/packages/composer/packages.json

如果返回空数组[]，说明组内无有效Composer包，需检查私有包的发布流程：确认发布时正确使用了GitLab Composer仓库配置，且流水线成功上传了包文件。

5. 强制指定包依赖（可选） #

若require-all: true无法匹配包，尝试明确指定包名：

"require": {
    "your-vendor/your-package": "*"
}

强制Satis拉取目标包，验证是否为require-all匹配逻辑问题。

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