Azure DevOps API偶发ETIMEDOUT超时问题求助及Node.js调用示例需求

我来帮你拆解这个超时问题，给出可行的解决方案，同时附上你需要的直接调用Azure DevOps API的Node.js示例：

一、偶发超时的可能根因 #

• 代理配置的潜在遗漏：你设置的代理绕过规则'visualstudio\.com'和'azure\.com'可能没覆盖所有Azure DevOps相关域名（比如dev.azure.com子域名），或者正则匹配逻辑在包内未生效，导致部分请求仍走代理触发超时
• 云端服务临时波动：Azure DevOps作为云服务，偶尔会有节点负载峰值、限流或短暂故障，这类问题通常重试即可恢复
• 连接实例未复用：每次调用都新建WebApi实例，会重复建立HTTP连接而非复用连接池，高频请求时容易出现连接耗尽或超时
• 默认超时时间过短：azure-devops-node-api的默认超时阈值可能偏短，轻微网络波动就会触发超时

二、针对性解决方案 #

1. 优化代理配置 #

确保绕过规则覆盖所有Azure DevOps相关域名，同时验证本地代理未拦截目标请求：

proxyBypassHosts: [
    '*.visualstudio.com',
    '*.azure.com',
    'dev.azure.com' // 明确添加常用域名
],

可以用抓包工具（如Fiddler）确认请求是否直接走公网，而非通过代理转发。

2. 复用WebApi实例 #

避免每次请求都新建连接，在工具类中缓存WebApi实例：

// 在AzureDevOpsHelper类中添加缓存逻辑
private _cachedWebApi?: vm.WebApi;

public async getCachedWebApi(): Promise<vm.WebApi> {
    if (this._cachedWebApi) {
        return this._cachedWebApi;
    }
    this._authentificationHandler = vm.getPersonalAccessTokenHandler(this.PAT);
    const option = {
        allowRetries: true,
        maxRetries: 5,
        timeout: 30000, // 延长超时到30秒
        ignoreSslError: true
    };
    if (InfraPortalConfig.ENVIRONMENT === InfraPortalConstant.LOCAL_ENVIRONMENT) {
        option.proxy = {
            proxyUrl: '',
            proxyUsername: '',
            proxyPassword: '',
            proxyBypassHosts: [
                '*.visualstudio.com',
                '*.azure.com'
            ],
        };
    }
    this._cachedWebApi = new vm.WebApi(this.AZURE_DEV_OPS_URL, this._authentificationHandler, option);
    return this._cachedWebApi;
}

然后在getRelease中复用缓存实例：

public async getRelease(projectName: string, releaseDefinitionId: number): Promise<releaseInterface.Release> {
    try {
        const vstsWebApiConnect = await AzureDevOpsHelper.getInstance().getCachedWebApi();
        const releaseApiConnect = await vstsWebApiConnect.getReleaseApi();
        return await releaseApiConnect.getRelease(projectName, releaseDefinitionId);
    } catch (error) {
        LogUtils.Instance.error(`** AzureDevOpsReleaseHelper - getRelease ${projectName} - ${releaseDefinitionId}: ${error}`);
        // 针对超时错误额外重试
        if (error.message.includes('ETIMEDOUT')) {
            await new Promise(resolve => setTimeout(resolve, 1000));
            return this.getRelease(projectName, releaseDefinitionId);
        }
        throw error;
    }
}

3. 增强重试策略 #

用指数退避重试替代简单重试，减少对服务端的压力：

// 封装通用重试函数
async function retry<T>(fn: () => Promise<T>, retries = 3, delay = 1000): Promise<T> {
    try {
        return await fn();
    } catch (error) {
        if (retries > 0 && (error.message.includes('ETIMEDOUT') || error.message.includes('ECONNRESET'))) {
            await new Promise(resolve => setTimeout(resolve, delay));
            return retry(fn, retries - 1, delay * 2); // 指数退避
        }
        throw error;
    }
}

// 在getRelease中使用重试
public async getRelease(projectName: string, releaseDefinitionId: number): Promise<releaseInterface.Release> {
    try {
        return await retry(async () => {
            const vstsWebApiConnect = await AzureDevOpsHelper.getInstance().getCachedWebApi();
            const releaseApiConnect = await vstsWebApiConnect.getReleaseApi();
            return await releaseApiConnect.getRelease(projectName, releaseDefinitionId);
        }, 3);
    } catch (error) {
        LogUtils.Instance.error(`** AzureDevOpsReleaseHelper - getRelease ${projectName} - ${releaseDefinitionId}: ${error}`);
        throw error;
    }
}

4. 排查本地网络稳定性 #

如果代理服务器经常不稳定，可尝试在本地环境直接禁用代理（网络允许的情况下），删除代理配置后测试是否还会出现超时。

三、直接调用Azure DevOps API的Node.js示例 #

以下是用axios直接调用原生API的示例，无需依赖azure-devops-node-api：

1. 获取发布信息 #

import axios from 'axios';

// 替换为你的配置
const PAT = 'your-personal-access-token';
const ORGANIZATION = 'your-org-name';
const PROJECT_NAME = 'your-project-name';
const RELEASE_ID = 123; // 要查询的发布ID

async function getReleaseDetails() {
    const apiUrl = `https://vsrm.dev.azure.com/${ORGANIZATION}/${PROJECT_NAME}/_apis/release/releases/${RELEASE_ID}?api-version=7.1-preview.8`;
    const authHeader = `Basic ${Buffer.from(`:${PAT}`).toString('base64')}`;

    try {
        const response = await axios.get(apiUrl, {
            headers: { 'Authorization': authHeader },
            timeout: 30000,
            // 本地代理配置（按需添加）
            proxy: {
                bypass: (host) => host.includes('visualstudio.com') || host.includes('azure.com')
            }
        });
        return response.data;
    } catch (error) {
        console.error('获取发布信息失败:', error);
        throw error;
    }
}

2. 排队触发新发布 #

import axios from 'axios';

// 替换为你的配置
const PAT = 'your-personal-access-token';
const ORGANIZATION = 'your-org-name';
const PROJECT_NAME = 'your-project-name';
const RELEASE_DEFINITION_ID = 123; // 发布定义ID

async function triggerRelease() {
    const apiUrl = `https://vsrm.dev.azure.com/${ORGANIZATION}/${PROJECT_NAME}/_apis/release/releases?api-version=7.1-preview.8`;
    const authHeader = `Basic ${Buffer.from(`:${PAT}`).toString('base64')}`;
    const payload = {
        definitionId: RELEASE_DEFINITION_ID,
        description: '通过API触发的发布',
        // 按需添加环境变量或其他配置
        environments: [{ name: 'Production' }]
    };

    try {
        const response = await axios.post(apiUrl, payload, {
            headers: {
                'Authorization': authHeader,
                'Content-Type': 'application/json'
            },
            timeout: 30000
        });
        return response.data;
    } catch (error) {
        console.error('触发发布失败:', error);
        throw error;
    }
}

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