上一篇刚写完给后台登录加邮箱验证码,转头做了一次代码审查,结果发现自己埋了一串坑。
大部分不是“代码跑不起来”的问题,而是那种平时不一定碰到、碰到就很烦的小问题。
测试邮箱把验证码拦了
.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,没 patchSMTP_SSL;在 SSL 配置下,测试可能根本没测到想测的东西。 - 重发测试把验证码固定成同一个值,就算重发接口什么都没做,旧验证码也能验证通过,测试发现不了。
现在两个都改了,另外补了发送失败、限流、次数耗尽的测试。
没修完的
还有一个“限流 helper 重复”的问题,属于维护性重复,不影响现在运行,先记着以后统一。
最后
这次代码审查抓到的不是“功能没写完”,而是边界上的问题:本地开发、取消登录、SMTP 故障、并发提交、会话失效。
功能能跑只是第一步,这些边角才是真的会让人烦的地方。
修完测试 140 个全过。后台登录现在是邮箱 + 密码 + 邮箱验证码,开了 TOTP 的话再加一层 TOTP。
评论
登录后评论
暂无评论。