Azure Functions(Node.js) JWT授权保护CRUD接口故障求助

错误原因 #

这个错误核心是你使用的JWT中间件（比如jsonwebtoken或express-jwt）是为Express框架设计的，但Azure Functions的HTTP触发函数参数结构和Express完全不同：

• Express中间件接收req, res, next参数，请求头存在req.headers
• Azure Functions的HTTP函数接收context参数，请求信息嵌套在context.req中

直接套用Express风格的中间件，会导致中间件试图读取不存在的req.headers，从而抛出错误。

正确实现方案 #

方案1：自定义适配Azure Functions的JWT验证逻辑 #

直接编写适配Azure Functions上下文的验证函数，避免依赖Express中间件：

const jwt = require('jsonwebtoken');

// 自定义JWT验证函数
async function validateJWT(context) {
    const authHeader = context.req.headers.authorization;
    // 检查Authorization头格式
    if (!authHeader || !authHeader.startsWith('Bearer ')) {
        context.res = {
            status: 401,
            body: '请提供有效的Bearer Token'
        };
        return false;
    }

    const token = authHeader.split(' ')[1];
    try {
        // 替换为你的JWT密钥，建议从环境变量读取
        const decoded = jwt.verify(token, process.env.JWT_SECRET);
        // 将解码后的用户信息挂载到context，供后续业务逻辑使用
        context.user = decoded;
        return true;
    } catch (error) {
        context.res = {
            status: 403,
            body: error.name === 'TokenExpiredError' ? 'Token已过期' : '无效的Token'
        };
        return false;
    }
}

在getuser/{userId}函数中调用验证逻辑：

module.exports = async function (context, req) {
    // 先执行JWT验证，失败则直接返回
    const isAuthorized = await validateJWT(context);
    if (!isAuthorized) return;

    // 验证通过，执行业务逻辑
    const targetUserId = req.params.userId;
    
    // 可选：添加权限校验，比如用户只能访问自己的信息
    if (context.user.userId !== targetUserId) {
        context.res = {
            status: 403,
            body: '无权限访问该用户信息'
        };
        return;
    }

    // 这里编写获取用户信息的逻辑（比如从数据库查询）
    context.res = {
        status: 200,
        body: {
            userId: targetUserId,
            username: context.user.username,
            email: context.user.email
        }
    };
};

方案2：通过适配层使用Express中间件 #

如果习惯Express生态的中间件，可以用@azure/functions-express将Azure Functions转为Express风格：

1. 安装依赖：

npm install @azure/functions-express express express-jwt

2. 配置Express应用并适配Azure Functions：

const express = require('express');
const { createHandler } = require('@azure/functions-express');
const expressJwt = require('express-jwt');

const app = express();

// 配置JWT中间件，排除登录接口
app.use(expressJwt({
    secret: process.env.JWT_SECRET,
    algorithms: ['HS256']
}).unless({ path: ['/api/login'] }));

// 定义getuser接口
app.get('/api/getuser/:userId', (req, res) => {
    const targetUserId = req.params.userId;
    
    // 权限校验
    if (req.user.userId !== targetUserId) {
        return res.status(403).json({ message: '无权限访问该用户信息' });
    }

    // 业务逻辑
    res.json({
        userId: targetUserId,
        username: req.user.username
    });
});

// 适配为Azure Functions处理函数
module.exports = createHandler(app);

关键注意事项 #

• 确保JWT_SECRET已配置在Azure Functions的应用设置中（本地开发用local.settings.json）
• 登录接口生成Token时，必须使用相同的密钥和签名算法（默认HS256）
• 生产环境建议将Token过期时间设置合理（比如1小时），并实现刷新Token机制

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