配置Redis Bull Board时访问/admin/queues提示地址无效如何解决

首先关于依赖安装的疑问 #

v3.x版本的bull-board已经拆分了核心API包和各框架的适配器包，@bull-board/express依赖@bull-board/api，你额外安装是正确的，这步操作没有问题。 #

404问题排查和修复方案 #

1. 调整Express中间件注册顺序

Express的中间件是按注册顺序依次执行的，如果你把bull board的路由注册写在了404兜底中间件、全局错误处理中间件的后面，请求会先被兜底中间件拦截，导致路由匹配失败。
请将bull board的注册逻辑放在所有兜底中间件之前，示例顺序：

// 优先注册bull board路由
serverAdapter.setBasePath('/admin/queues')
app.use('/admin/queues', serverAdapter.getRouter());

// 再注册业务路由
app.use('/api/xxx', xxxRouter)

// 最后才注册404、错误处理中间件
app.use((req, res) => {
  res.status(404).send('页面地址无效')
})

2. 修复版本兼容问题

你当前使用的@bull-board/api v3.7.0不兼容bull v4.x版本，bull v4修改了大量内部API，旧版的BullAdapter无法正常适配，有两种修复方案：

• 方案一：将bull降级到v3.x版本，执行命令：npm i bull@3.29.0
• 方案二：将bull-board升级到v4及以上版本，执行命令：npm i @bull-board/api@latest @bull-board/express@latest

3. 检查路由匹配规则

如果你的Express开启了严格路由（strict routing）或大小写敏感路由，需要严格匹配路径：

• 不要加多余的末尾斜杠，访问地址改为http://localhost:8000/admin/queues
• 确认全局没有配置额外的路由前缀，比如全局配置了app.use('/service', ...)，实际访问地址需要改为http://localhost:8000/service/admin/queues

4. 验证服务启动日志

启动Express服务后检查控制台是否有报错，确认队列初始化、Redis连接没有抛出异常。 #

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