fix(后台): 403 不再一律当未登录整页踢回登录页

拦截器把 body.code 401 和 403 并成一支,任何一个业务端点的授权缺口都会表现为
"登录坏了":整页 assign 到 /login,当前页连人带未提交的表单一起没了,下一次同类
缺口还得重新做一次归因。收窄成只有会话引导端点(current-user、current-user/menus)
的 403 才跳登录页 —— 那里 403 才真的等于"这个账号进不了后台"(如拿客户端 token 打开后台)。
业务端点的 403 交回页面自己报错,UsersPage 那句"拉失败时列表照常显示、但要把原因说出来"
从此才成立。

判定做成 envelope.ts 的纯函数 shouldRedirectForbidden,两支拦截器都过它;用例同时钉
正反两向(业务端点不跳、引导端点照跳、前缀相似不算)并断言扫描集非空。
This commit is contained in:
2026-10-04 12:57:56 +08:00
parent 3f223f045b
commit 2b55f71610
3 changed files with 97 additions and 8 deletions
@@ -0,0 +1,64 @@
import test from 'node:test'
import assert from 'node:assert/strict'
import { readSource } from './helpers.ts'
import {
SESSION_BOOTSTRAP_PATHS,
isForbidden,
isUnauthorized,
shouldRedirectForbidden,
} from '../src/api/envelope.ts'
/**
* 403 的分流(2026-10-04 生产:"阿武登录后台闪退")。
*
* Java 的 BusinessException 一律 HTTP 200 + body.code,401/403 都藏在 body 里;
* 拦截器原先把 403 与 401 并成一类整页跳 /login,于是「用户管理」页那个
* GET /api/admin/companies 的菜单闸门 403,在管理员眼里就成了"登录坏了"。
*/
test('业务端点的 403 不再按未登录处理:这就是那次闪退的出口', () => {
for (const url of ['/api/admin/companies', '/api/admin/users', '/api/admin/shop-center']) {
assert.equal(shouldRedirectForbidden(url), false, `${url} 的 403 不该把人踢回登录页`)
}
})
test('会话引导端点的 403 仍然跳登录页:非管理员账号进不了后台这条出路要留着', () => {
assert.deepEqual([...SESSION_BOOTSTRAP_PATHS], [
'/api/admin/current-user',
'/api/admin/current-user/menus',
])
for (const url of SESSION_BOOTSTRAP_PATHS) {
assert.equal(shouldRedirectForbidden(url), true, `${url} 的 403 应跳登录页`)
}
})
test('403 判定认绝对 URL 与带查询串的形态,但不认前缀相似的路径', () => {
assert.equal(shouldRedirectForbidden('http://api.aishufu.top/api/admin/current-user'), true)
assert.equal(shouldRedirectForbidden('/api/admin/current-user?device=web'), true)
// 前缀像但不是同一个端点:/api/admin/current-user-anything 不该被当成会话引导
assert.equal(shouldRedirectForbidden('/api/admin/current-users/2'), false)
assert.equal(shouldRedirectForbidden(undefined), false)
assert.equal(shouldRedirectForbidden(''), false)
})
test('401/403 仍能各自认出,收窄 403 不会顺手把 401 也放过', () => {
assert.equal(isUnauthorized({ code: 401 }), true)
assert.equal(isForbidden({ code: 403 }), true)
assert.equal(isForbidden({ status: 403 }), true)
assert.equal(isUnauthorized({ code: 403 }), false)
assert.equal(isForbidden({ code: 401 }), false)
})
test('拦截器两支都必须先过 403 分流,且不再把 403 并进 401 那一支', () => {
const http = readSource('src/api/http.ts')
assert.match(http, /shouldRedirectForbidden/, '403 分支要经分流判定')
assert.match(http, /redirectToLoginOnForbidden\(response\.config\?\.url\)/, '成功分支(200+body.code)走分流')
assert.match(http, /redirectToLoginOnForbidden\(error\?\.config\?\.url\)/, '异常分支同样走分流')
assert.doesNotMatch(
http,
/isUnauthorized\([^\)]*\)\s*\|\|\s*isForbidden/,
'403 不许再和 401 共用一个无条件跳转分支',
)
// 401 那条路原样保留
assert.match(http, /redirectToLogin\(response\.config\?\.url\)/)
})