TypeScript迁移报错：Property 'email'不存在于string | JwtPayload类型

jwt.decode()的返回类型为string | JwtPayload，TypeScript无法确定解码结果是字符串还是包含用户信息的对象，直接访问username属性会触发类型错误。以下是几种实用的解决方法：

方法1：类型断言（快速直接） #

如果能确定token解码后必然是包含username的对象，可以用类型断言明确其类型：

try {
    const token = await TokenController.getTokenFromRequest(req);
    // 断言为JwtPayload类型，或自定义扩展类型
    const decoded = jwt.decode(token) as JwtPayload;
    const user = await AuthController.getUserByMail(decoded.username);
    res.json(user);
} catch (error: any) {
    ErrorController.errorCallback(error, res);
}

如果需要更精确的类型，可以自定义接口：

interface DecodedToken extends JwtPayload {
  username: string;
}

// 断言为自定义类型
const decoded = jwt.decode(token) as DecodedToken;

方法2：类型守卫（安全可靠） #

通过类型检查确保解码结果是预期的对象，避免断言出错导致运行时问题：

try {
    const token = await TokenController.getTokenFromRequest(req);
    const decoded = jwt.decode(token);
    
    // 检查是否为包含username属性的对象
    if (typeof decoded === 'object' && decoded !== null && 'username' in decoded) {
        const user = await AuthController.getUserByMail(decoded.username);
        res.json(user);
    } else {
        // 处理无效token的情况
        res.status(401).json({ message: '无效的身份令牌' });
    }
} catch (error: any) {
    ErrorController.errorCallback(error, res);
}

方法3：使用jwt.verify()（推荐） #

jwt.verify()会同时验证token的签名、有效期等合法性，返回的类型更可靠，还能提升接口安全性：

try {
    const token = await TokenController.getTokenFromRequest(req);
    // 验证token并解码，需传入你的JWT密钥
    const decoded = jwt.verify(token, process.env.JWT_SECRET_KEY) as JwtPayload;
    const user = await AuthController.getUserByMail(decoded.username);
    res.json(user);
} catch (error: any) {
    ErrorController.errorCallback(error, res);
}

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