我们为什么会在意一个斜杠?
我们自己的站点,构建完会跑一个脚本,检查每个内部链接是不是都带结尾斜杠。这不是洁癖。不带斜杠的地址会先被服务器 308 跳转一次,搜索引擎的站长工具把这些跳转统统记成“有重定向的网页”,一条一条地报给我们看。
所以当我们读到一份社区反馈,说有人的 EmDash 站点登录不了通行密钥,而站点前面恰好有一层会给地址补斜杠的东西,我们的第一反应不是同情,是心虚:这种配置,我们自己也会顺手加上。
于是我们新建了一个博客模板站(EmDash 1.4.0,Node 适配器,SQLite),把它复现了一遍。
登录失败时,到底是哪一步在出错?
通行密钥登录的第一步,是页面先向服务器要一份“挑战”,请求地址是 /_emdash/api/auth/passkey/options。浏览器弹出指纹或安全密钥的提示,是在这一步成功之后。
我们没办法让脚本替人按指纹,所以只测这一步,用 curl,分别带斜杠和不带斜杠:
curl -i -X POST http://localhost:4400/_emdash/api/auth/passkey/options \
-H 'X-EmDash-Request: 1' -H 'Content-Type: application/json' -d '{}'
curl -i -X POST http://localhost:4400/_emdash/api/auth/passkey/options/ \
-H 'X-EmDash-Request: 1' -H 'Content-Type: application/json' -d '{}'
第一条返回 200,里面是一份挑战和 rpId。第二条只多了一个斜杠,返回:
{"success":false,"error":{"code":"NOT_AUTHENTICATED","message":"Not authenticated"}}
/_emdash/api/auth/mode 和 /_emdash/api/health 也一样:不带斜杠 200,带斜杠 401。
顺带记一个小插曲。我们一开始是用浏览器式的 GET 去访问 passkey/options 的,得到的是一整页 404 的 HTML,差点以为接口不存在。它只接受 POST。
为什么是 401,而不是 404?
我们去翻了 EmDash 认证中间件的源码。里面有一份“不用登录也能访问”的接口名单,分两种写法:以 / 结尾的条目按前缀匹配,其余的按整串精确匹配。passkey/options、passkey/verify、auth/mode、health 都写在精确匹配里。
地址多出一个斜杠,就不再等于名单里的任何一条。中间件于是把它当成一个普通的、需要登录的接口来处理。而你此刻正是为了登录才发的这个请求。
结论有点绕口,但就是这样:登录的第一步,被判定为需要先登录。
如果我就是把 trailingSlash 设成了 always 呢?
我们也试了这个。在 astro.config.mjs 里加上:
export default defineConfig({
trailingSlash: "always",
// ...
});
再测同一个接口:
| 请求地址 | 结果 |
|---|---|
/_emdash/api/auth/passkey/options | 404 |
/_emdash/api/auth/passkey/options/ | 401 NOT_AUTHENTICATED |
两边都走不通。我们没有去抓管理页面实际会发出哪一种地址,所以不确定页面会落在哪一边,但无论落在哪边,都登录不了。
现在该怎么办?
第一,先把 trailingSlash 改回默认值(不写就是 ignore)。我们在默认值下测过:页面带不带斜杠都能打开,登录接口也正常。
第二,如果斜杠是你前面的代理或网关加的,让它对 /_emdash/ 开头的路径放行,不要改写。这一条我们没有在真实的代理上试过,是按上面的原理推出来的,请你自己验证。
第三,关于版本。 我们测的是 1.4.0。社区里对应的修复已经合并进了主干,但我们测试的时候,最新的发布版仍然是 1.4.0,没有带上它。所以以后你升级了,不要想当然,把上面那两条 curl 再跑一遍,十秒钟的事。
为什么魔法链接登录还是好的?
那份反馈里提到,魔法链接登录一直正常。照着名单看,这不奇怪:auth/magic-link/ 是以斜杠结尾的条目,走的是前缀匹配,后面多一个斜杠,并不影响它。这是我们根据名单做的推断,没有单独去验证。
怎么判断自己是不是中招?
两件事,同时满足才是:
- 通行密钥登录时报
Not authenticated,魔法链接登录却正常。 - 上面那条带斜杠的 curl 返回
401,不带斜杠的返回200。
如果第二条里两个都是 200,那你遇到的是别的问题,这篇文章帮不上忙。