网站首页需设meta: { public: true }放行,后台路由须标记requiresAuth并用checkAuth配合next跳转登录页,登录页自身必须public且不触发拦截。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

想让网站首页对所有人开放查看,但后台管理页面必须登录后才能访问,这是常见于高校通知系统、教务平台或内部协作工具的权限分层需求。函子Zion作为轻量级权限控制中间件,不自带用户系统,需配合已有登录态实现路由级拦截。
确认Zion版本与基础环境
打开项目终端,执行 npm list @zionjs/core 或 yarn list @zionjs/core,确保已安装 2.3.0 及以上版本。低于此版本不支持独立路由守卫配置,强行设置会导致首页白屏。
检查当前项目是否已集成统一登录服务(如CAS、OAuth2或学校SSO)。Zion本身不处理登录,只消费 【loginStatus】 这个全局状态变量——它必须由你自己的登录模块在用户成功认证后主动挂载到 window 对象上,例如:window.loginStatus = { userId: '20261113001', role: 'admin' };
首页路由放行配置
在 router/index.js(或对应路由定义文件)中,为首页路径(如 '/' 或 '/home')显式添加 meta: { public: true } 标识:
{ path: '/', name: 'Home', component: () => import('@/views/Home.vue'), meta: { public: true } }
这一步不可省略。Zion默认所有路由都受保护,只有明确标记 public: true 的才会跳过登录校验。漏加会导致首页也强制跳转登录页。
后台路由登录拦截
第一步:在路由元信息中为后台路径统一打标
给所有需要登录的路由(如 '/admin', '/dashboard', '/user/manage')添加 meta: { requiresAuth: true }。不需要逐个写,可用正则批量匹配:path: '/admin/*' 或用命名空间方式统一归类。
第二步:在 router.beforeEach 全局前置守卫中插入Zion拦截逻辑
引入 Zion 的 checkAuth 工具函数:import { checkAuth } from '@zionjs/core';。然后在守卫回调里写:if (to.meta.requiresAuth && !checkAuth()) { next('/login?redirect=' + encodeURIComponent(to.fullPath)); return; }
注意:【checkAuth() 返回 false 时不会自动跳转,必须手动调 next()】。若只写 if (!checkAuth()) { next('/login') } 而不加 redirect 参数,用户登录后将回到首页而非原目标页,体验断裂。
第三步:确保登录页自身允许匿名访问
登录路由(如 '/login')必须同时满足两个条件:① meta: { public: true };② 不在 requiresAuth 拦截范围内。否则会陷入「没登录→跳登录→登录页被拦→再跳登录」的死循环。


















