WebStorm中async函数出现‘Redundant await for a non-promise type’警告的原因与解决

问题原因 #

1. 静态分析分支覆盖不全：你的getAccessToken函数仅处理了github和linkedin两种provider场景，未添加默认else分支。虽然async函数无论代码路径如何都会返回Promise，但WebStorm的静态类型推断可能误判存在未明确返回值的路径，从而错误认定函数返回非Promise类型，触发冗余await警告。
2. IDE缓存/索引异常：WebStorm的项目缓存或代码索引出现异常，导致无法正确识别async函数的返回类型。

解决方法 #

1. 补充默认分支，完善代码路径覆盖 #

给getAccessToken添加默认分支，明确所有场景的返回/抛出逻辑，让IDE能准确识别函数返回Promise：

exports.getAccessToken = async (provider, clientId, clientSecret, code, redirectUri) => {
    if (provider === "github") {
        const response = await axios.post(
            'https://github.com/login/oauth/access_token',
            { client_id: clientId, client_secret: clientSecret, code },
            { headers: { Accept: 'application/json' } }
        );
        return response.data.access_token;
    } else if (provider === "linkedin") {
        const response = await axios.post(
            'https://www.linkedin.com/oauth/v2/accessToken',
            null,
            {
                params: {
                    grant_type: 'authorization_code',
                    code,
                    redirect_uri: redirectUri,
                    client_id: clientId,
                    client_secret: clientSecret,
                },
                headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
            }
        );
        return response.data.access_token;
    } else {
        // 补充默认分支，抛出不支持的provider错误
        throw new Error(`不支持的授权服务商：${provider}`);
    }
};

2. 用JSDoc手动指定返回类型 #

通过JSDoc注释明确函数返回Promise，强制WebStorm识别正确的返回类型：

/**
 * 获取第三方授权访问令牌
 * @param {string} provider 授权服务商标识
 * @param {string} clientId 客户端ID
 * @param {string} clientSecret 客户端密钥
 * @param {string} code 授权码
 * @param {string} redirectUri 回调地址
 * @returns {Promise<string>} 访问令牌
 */
exports.getAccessToken = async (provider, clientId, clientSecret, code, redirectUri) => {
    // 原有函数逻辑
};

3. 重置WebStorm缓存与索引 #

如果是IDE缓存导致的识别错误，可通过以下步骤重置：

• 点击顶部菜单栏 File -> Invalidate Caches...
• 在弹窗中勾选Invalidate and Restart，等待WebStorm重启并重新索引项目。

4. 检查JavaScript版本配置 #

确保WebStorm支持async/await语法：

• 打开Settings（Windows/Linux：File→Settings；Mac：WebStorm→Settings）
• 进入Languages & Frameworks → JavaScript
• 将JavaScript language version设置为ECMAScript 2017或更高版本。

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