上一篇刚写完给后台登录加邮箱验证码,转头做了一次代码审查,结果发现自己埋了一串坑。

大部分不是“代码跑不起来”的问题,而是那种平时不一定碰到、碰到就很烦的小问题。

测试邮箱把验证码拦了

.env.example 里管理员邮箱是 admin@example.com。我为了防退信,加了一个“跳过测试收件地址”的判断,结果它排在了 DEBUG 打印兜底的前面。

也就是说,别人照抄示例、本地没配 SMTP 时,后台登录验证码既不会发,也不会打印,直接卡住。

修复很简单:先判断邮件开关和 SMTP,再判断测试地址。没有 SMTP 且 DEBUG 打开时,验证码老老实实打印到终端。

验证码页没有出口

密码正确后会进入验证码页。如果这时想放弃登录,点“返回登录”,会被 GET /admin/login 直接又送回验证码页,因为 Session 里还有 pending code。

自己把自己关在门外。

现在加了一个“取消并返回登录”的按钮,会删掉待验证码、清 Session,再回登录页。

发送失败不算限流

验证码发送失败时,原来的逻辑是直接返回 503,发送次数没有记录。

如果 SMTP 挂了,拿着管理员密码的人可以反复触发发送,每次还可能卡到超时,限流桶一直是空的。

现在改成发送前就记录,不管最后成没成,都算一次。该拦的时候就拦。

并发点两下可能 500

错误验证码次数的处理是“读出来、加一、写回去”。两个请求同时到的时候,可能一个把记录删了,另一个再提交就报 StaleDataError,页面直接 500。

把这段逻辑抽成公共函数,顺手捕获了这个异常。现在两个请求同时来,最多是其中一个正常退出,不会再炸页面。

重发前要重新看管理员状态

验证码页可以重发。原来的重发只信 Session 里的邮箱和版本号,没有再看管理员账号是否还在、邮箱是否还对、会话版本是否一致。

如果刚重置过密码或者改过管理员邮箱,旧 Session 还能触发重发,邮件就发到了一个已经不该用的地址。

现在重发前会重新查管理员,状态不对就删掉待验证码,回登录页。

测试自己也有问题

代码审查还抓了两个测试问题:

  • 只 patch 了 smtplib.SMTP,没 patch SMTP_SSL;在 SSL 配置下,测试可能根本没测到想测的东西。
  • 重发测试把验证码固定成同一个值,就算重发接口什么都没做,旧验证码也能验证通过,测试发现不了。

现在两个都改了,另外补了发送失败、限流、次数耗尽的测试。

没修完的

还有一个“限流 helper 重复”的问题,属于维护性重复,不影响现在运行,先记着以后统一。

最后

这次代码审查抓到的不是“功能没写完”,而是边界上的问题:本地开发、取消登录、SMTP 故障、并发提交、会话失效。

功能能跑只是第一步,这些边角才是真的会让人烦的地方。

修完测试 140 个全过。后台登录现在是邮箱 + 密码 + 邮箱验证码,开了 TOTP 的话再加一层 TOTP。