导出功能失效的四大原因及对策：一是前端权限钩子（如canExport）返回false导致按钮无响应；二是后端导出接口未绑定鉴权中间件或被流式响应跳过校验；三是UI层角色白名单硬编码未适配新角色；四是数据范围、字段、行数等后端权限控制缺失，导致越权或异常。

导出按钮还在但点不动：检查 canExport 权限钩子

很多系统（比如基于 ant design pro、react-admin 或自研后台）的导出功能不是靠按钮显隐控制，而是靠运行时拦截。用户看到 export 按钮却点击无反应，大概率是权限校验卡在了 canexport 这类布尔钩子上。

实操建议：

• 全局搜索项目中是否定义了 canExport、hasExportPermission 或类似命名的函数/变量
• 检查该函数是否读取了当前用户角色（如 user.role === 'guest'），并直接返回 false
• 注意它可能被包裹在 HOC 或自定义 Hook 里，别只盯着按钮组件本身
• 临时加一行 console.log('canExport:', result) 确认实际返回值

后端接口 403 但前端没提示：导出请求绕过了常规权限中间件

导出常走 /api/export?xxx 这类 GET 接口，容易被忽略——它可能没走和 /api/users 一样的鉴权逻辑，或者用了独立的 controller，漏掉了角色白名单校验。

实操建议：

• 抓包确认导出请求的真实 URL 和 method，再查对应后端路由是否绑定了权限中间件（如 Express 的 checkRole(['admin', 'editor'])）
• 检查该接口是否用了 res.download() 或流式响应，导致中间件提前结束，跳过后续校验
• 避免用 query 参数传敏感筛选条件（如 ?role=guest），否则可能被篡改绕过；应从 token 或 session 中取用户身份

Excel 导出按钮消失：UI 层角色判断写死了数组，没适配新角色

常见错误是把可导出角色硬编码成 ['admin', 'editor']，后来加了 'auditor' 角色但忘了同步更新。结果 auditor 登录后按钮直接不渲染，连拦截机会都没有。

实操建议：

• 把角色白名单抽成配置项，比如 EXPORT_ALLOWED_ROLES = ['admin', 'editor', 'auditor']，统一管理
• 避免在 JSX 里写 {user.role === 'admin' && <button onclick="{exportData}">导出</button>}，改用 {EXPORT_ALLOWED_ROLES.includes(user.role) && ...}
• 如果用 RBAC 模型，优先查权限码（如 hasPermission('data:export')），而非角色名——角色可变，权限码更稳定

导出文件内容被裁剪或报错：权限控制不能只拦入口，还得管数据范围

拦住按钮或接口只是第一步。更隐蔽的问题是：普通用户调用导出时，后端没限制查询范围，结果导出了全量数据，或触发内存溢出（OOM）、超时（504），甚至泄露敏感字段。

实操建议：

• 导出前强制加数据过滤条件，例如对 guest 角色，SQL 必须带上 WHERE created_by = ? 或 tenant_id = ?
• 禁止导出含 password_hash、id_card 等字段的表，哪怕用户有“查看”权限，导出也应脱敏或排除
• 给导出任务设硬性上限，比如单次最多导 1000 行，超限返回明确错误："Export limit exceeded for your role"

权限不是开关，是链条。按钮、接口、查询、字段、行数，每一环都可能漏掉——尤其当导出逻辑分散在多个 service 或脚本里时，最容易只改了一处。