设计配对码：权衡、常见错误与简易有效方法
Source: Dev.to
请提供您希望翻译的完整文本内容，我将按照要求将其翻译为简体中文并保留原有的格式、Markdown 语法以及技术术语。谢谢！
介绍
在构建 Booth Beam（一款数字标牌工具）时，我遇到了一个乍看之下似乎很简单的问题：如何以快速、可靠且不易出错的方式将电视连接到网页应用？
你可以强制用户在电视上登录，但任何用遥控器输入电子邮件和密码的人都知道那有多痛苦。正因如此，大多数现代应用都完全避免这种方式。
像 Netflix 这类应用采用的做法既简单又有效：配对码。不是直接在电视上登录，而是在屏幕上显示一个短码，让用户在他们真正喜欢使用的设备上输入，比如手机或笔记本电脑。这个小小的转变消除了摩擦，使整个体验感觉瞬间完成。
在 Booth Beam 中，流程非常直接：
- 用户在电视上打开应用，立即看到一个配对码。
- 他们在笔记本或手机上打开网页应用，输入该码，电视即完成连接。
- 从此以后，他们可以随时向屏幕发送内容，而无需再次思考配对过程。
这是一项一次性的操作，应该让人感觉轻而易举。
实际约束
人们常常想“只要随便生成一个随机码就行”，但一些实际约束会迅速使问题变得复杂。
- 可读性 – 用户经常在远距离输入这些码，有时还在会议或活动等嘈杂环境中。
- 容错性 – 错误在所难免，系统应尽量降低混淆的可能性。
- 有效期 – 码必须是短期有效的（在我的案例中，五分钟后失效）。
- 并发性 – 多台电视可以同时生成码；第一个输入有效码的人将获得该连接。
在后台，码会存储在数据库中，唯一性受到约束，已使用或已过期的条目会定期清理。
注意： 这不是身份验证。这是临时设备关联。其安全模型与 Netflix 等应用使用的相同：短期有效码、受限的活跃集合以及狭窄的机会窗口。
选择字符集
The first design decision is what the codes should look.
| 选项 | 优点 | 缺点 |
|---|---|---|
| 仅数字 | 生成简单 | 数字在远处容易混淆；每个字符的组合较少 → 代码更长 |
| 仅字母 | 可读性稍好 | 组合仍受限；有生成真实单词的风险（尴尬情况） |
| 字母数字（字母 + 数字） | 可能性更大；可以在不牺牲唯一性的情况下保持代码简短 | 必须处理易混淆字符（例如 0 vs. O） |
我选择了 字母数字 方案。
长度和组合空间
使用 26 个字母和 10 个数字，共有 36 种可能的字符。
一个 4‑character 代码产生：
36^4 = 1,679,616 combinations乍一看，这似乎足够多。但一旦考虑到人们实际阅读和输入这些代码的方式，就会出现实际问题。
删除模糊字符
数字 0 与字母 O 之间的经典混淆是错误的主要来源。
解决方案： 从字符集排除 0 和 O。
现在你有 25 个字母 + 9 个数字 = 34 个字符：
34^4 = 1,336,336 combinations你会失去一些组合，但获得了清晰——在此情境下更为重要。
避免出现不想要的词语
随机的字母数字字符串有时会形成真实的单词，其中一些可能不适合在会议展位上展示。
一种天真的解决方案是维护一个脏话过滤器，但：
- 没有任何列表是完整的。
- 语言和俚语在不断演变。
- 维护列表成为一项永无止境的工作。
与其事后过滤，不如设计系统，使得单词永远不可能出现。
强制包含数字
如果每个代码始终至少包含一个数字，它就不可能是纯文字。
实现提示： 在4字符代码的第2或第3位强制放置数字。
在此约束下，总组合数变为：
9 * 34^3 = 353,304这仍然足以满足短期使用的代码和相对较少的活跃设备。如果需要更多容量，可以将长度增加到五或六个字符。关键是保持方案简单且可预测。
处理冲突
即使有数十万种可能的组合，冲突仍然可能发生。
一个 简单的重试循环 就足够了：
- 生成一个代码。
- 检查它是否已经存在于数据库中。
- 如果已存在，则再生成一个并重复。
因为代码的生命周期短且活跃集合很小，重复冲突的概率很低。引入更复杂的机制只会增加维护成本，却没有实质性的好处。
代码生命周期
- Generation – 代码被创建并存储在数据库中，带有时间戳和“未使用”标记。
- Display – 电视向用户显示代码。
- Entry – 用户在五分钟内在手机/笔记本电脑上输入代码。
- Verification – 服务器检查代码的存在性、有效期以及“未使用”状态。
- Mark as Used – 验证成功后，代码被标记为“已使用”并关联到电视的会话。
- Expiration/Cleanup – 后台任务定期删除超过五分钟的代码或已标记为已使用的代码。
摘要
- Alphanumeric（排除
0和O）提供了一套干净、易读的 34 个字符。 - 一个 4‑character 代码，至少包含一个数字，提供 353 k 种可能的取值——足以应对短期、低并发的场景。
- Collision handling 可以像重试循环一样简单。
- lifecycle 为 生成 → 显示 → 输入 → 验证 → 使用 → 清理。
这种设计使配对体验保持 快速、可靠且不易出错，同时避免了字符歧义、意外出现不雅词汇以及不必要的复杂性。