thinkphp验证码默认字母数字混合，不显示或校验失败主因是session未启用或gd扩展缺失；需确认session中间件开启、无输出污染、图像生成与校验使用同一机制。
ThinkPHP 验证码默认就是字母+数字混合的，不是纯数字，也不需要额外配置「开启字母」——只要没手动限定 codeSet 为纯数字，它就会自动混用大小写字母和数字。但很多人卡在「不显示」或「总校验失败」，根本原因不是字母问题，而是五步链断了一环。
captcha_check() 总返回 false 的真实原因
这不是验证码逻辑错了，而是 Session 没存住原始值。TP6/TP8 默认禁用 Session 中间件，captcha_check() 查不到 session 里的 verify_code，只能返回 false。
- 检查
app/middleware.php是否有\think\middleware\SessionInit::class且未被注释 - 别在控制器里写
session_start()—— TP 的 Session 必须由中间件初始化，手动调用无效 - 快速验证：在任意接口里写
session('test', 'ok'); var_dump(session('test'));，输出"ok"才算通 - GD 扩展未启用也会导致
captcha_check()假失败（因为图像生成阶段就崩了，session 根本没写进去）
验证码图片空白或 404 的常见触发点
captcha_img() 或 url('index/captcha') 返回空白图，90% 是响应头或输出污染问题。
- 控制器里千万别用
new Captcha()->create()后直接return—— 它会尝试输出二进制图像，但若前面已有空格、BOM、echo或日志打印，HTTP 头就已发送，图像必然损坏 - 模板中用
{:captcha_img()}最稳，它内部做了 header 设置和 exit，不会被后续内容干扰 - 如果手写接口，必须确保方法里没有其他输出，且结尾是
return $captcha->entry();（TP6/TP8）或$captcha->entry(); exit;（TP5） - TP3/TP3.2 用户注意：
Image::buildImageVerify()前不能有任何输出，连文件末尾的换行都不行
如何控制字母是否参与、大小写是否敏感
ThinkPHP 验证码的字符集和校验行为由配置驱动，不是硬编码。关键参数都在 captcha.php 或实例化时传入：
-
codeSet决定可用字符：'0123456789'→ 纯数字；'23456789ABCDEFGHJKLMNPQRSTUVWXYZ'→ 去掉易混淆字符（如 O、I、0） -
useZh为true时才走中文路径，否则一律按codeSet走字母数字混合 - 校验默认区分大小写；若想不区分，得改源码或自己封装一层：
captcha_check(strtolower($input)) -
length控制位数，但不会影响字符类型 —— 即使设为 4，只要codeSet含字母，就可能出A3fK这种组合
最常被忽略的是：验证码一次性有效 + 依赖 Session + 图像生成与校验必须用同一套机制。比如前端 JS 刷新了两次，后端却只校验第一次生成的值，必然失败；又或者你用了 captcha_img() 渲染，却在后端手动 new Captcha 校验，Session key 对不上，也白搭。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
