Node.js中https.get设置GitLab API请求头失败，求正确实现方式

我在使用Node.js的https.get函数调用GitLab API时，遇到了请求头设置的问题。目标接口要求携带PRIVATE-TOKEN请求头，对应的curl命令如下：
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects"

我尝试了以下三种写法，均未得到正确响应：

错误写法1 #

const options = {
    hostname: 'gitlab.example.com',
    path: '/api/v4/projects',
    headers: {
        "PRIVATE-TOKEN": "<your_access_token>"
    }
}

https.get(options, (resp) => {
    ...
})

错误写法2 #

const options = {
    hostname: 'gitlab.example.com',
    path: '/api/v4/v4/projects',
    headers: "PRIVATE-TOKEN: <your_access_token>"
}

https.get(options, (resp) => {
    ...
})

错误写法3 #

const options = {
    hostname: 'gitlab.example.com',
    path: '/api/v4/projects',
    headers: {
        "PRIVATE-TOKEN: <your_access_token>":""
    }
}

https.get(options, (resp) => {
    ...
})

问题分析与正确写法 #

先拆解三种错误的核心问题：

• 写法2的headers必须是对象类型，不能直接传字符串；同时path多写了一个v4，路径本身就错误。
• 写法3把完整的请求头键值对当成了键名，完全不符合HTTP请求头的格式规范。
• 写法1的格式本身是正确的，没得到响应大概率是你替换<your_access_token>时用了占位符而非真实令牌，或者hostname填的是示例域名而非你的GitLab实例真实域名。

正确的写法基于写法1的格式，只需确保以下几点：

1. 把<your_access_token>替换为你实际的GitLab访问令牌；
2. hostname替换为你的GitLab实例域名（比如公网的gitlab.com或私有部署的域名）；
3. path保持正确，不要重复v4。

完整可运行示例：

const https = require('https');

const options = {
    hostname: 'gitlab.example.com', // 替换为你的GitLab真实域名
    path: '/api/v4/projects',
    headers: {
        "PRIVATE-TOKEN": "你的GitLab访问令牌" // 替换为实际令牌
    }
};

https.get(options, (resp) => {
    let data = '';

    // 接收响应数据片段
    resp.on('data', (chunk) => {
        data += chunk;
    });

    // 响应结束后处理完整数据
    resp.on('end', () => {
        try {
            console.log(JSON.parse(data));
        } catch (err) {
            console.log('响应解析错误:', err);
        }
    });

}).on("error", (err) => {
    console.log("请求出错: " + err.message);
});

也可以直接传入完整URL的写法，同样需要设置headers：

const https = require('https');

const url = 'https://gitlab.example.com/api/v4/projects';
const options = {
    headers: {
        "PRIVATE-TOKEN": "你的GitLab访问令牌"
    }
};

https.get(url, options, (resp) => {
    // 响应处理逻辑同上
}).on("error", (err) => {
    console.log("请求出错: " + err.message);
});

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