在Node.js/Express.js中自定义中间件集成Keycloak.protect()的需求

DevOps 小满

2026-8-19

实现自定义Keycloak认证标识中间件

思路说明

放弃keycloak.protect()的强制拦截逻辑，改为在中间件里检查用户认证状态但不阻断请求
在请求对象上添加自定义标识，让后续处理函数能根据这个标识返回对应数据量

编写verifytoken中间件

假设你已完成Keycloak基础配置，有可用的keycloak实例，直接编写中间件：

const verifytoken = async (req, res, next) => {
  try {
    // 从请求头提取Bearer令牌
    const token = req.headers.authorization?.split(' ')[1];
    if (token) {
      // 用Keycloak工具验证令牌有效性
      await keycloak.grantManager.validateAccessToken(token);
      req.isAuthenticated = true; // 标记为已认证
    } else {
      req.isAuthenticated = false; // 无令牌，标记未认证
    }
  } catch (err) {
    // 令牌无效或验证失败，标记未认证
    req.isAuthenticated = false;
  }
  // 无论认证结果如何，放行到下一个处理函数
  next();
};

路由配置

保持你原有的路由写法即可：

router.get('/v1/endpoint', verifytoken, apis.getData);

修改getData处理逻辑

在apis.getData中根据中间件添加的标识返回对应数据：

// apis.js中的getData函数
exports.getData = (req, res) => {
  if (req.isAuthenticated) {
    // 已认证用户返回完整数据
    return res.status(200).json({
      code: 200,
      data: ['完整数据项1', '完整数据项2', '完整数据项3'],
      message: '已认证用户'
    });
  } else {
    // 未认证用户返回精简数据
    return res.status(200).json({
      code: 200,
      data: ['精简数据项1'],
      message: '未认证用户'
    });
  }
};