thinkphp 5.1.41 验证码不显示主因是gd库未完整启用（缺freetype支持）、输出被bom/错误/空格污染、session未初始化或不可写；需依次验证gd_info()['freetype support']为true、调用ob_clean()、确认sessioninit中间件启用且runtime/cache/captcha可写。
ThinkPHP 5.1.41 验证码不显示，基本不是框架版本 bug，而是环境或配置环节出了问题。核心要抓住三点：GD 库是否真正可用、输出是否被污染、Session 是否正常工作。下面按排查优先级给出实用解决路径。
确认 GD 扩展已完整启用
验证码依赖 GD 绘图，缺一不可。光有 extension=gd 不够，还必须支持 TrueType 字体渲染：
- 终端执行
php -m | grep gd，确认有输出； - 再运行
php -r "var_dump(gd_info()['FreeType Support']);"，必须返回 bool(true)； - 若为
false，说明 FreeType 未编译进 GD —— Ubuntu/Debian 装libfreetype6-dev，CentOS 装freetype-devel，PHP 源码编译需加--with-freetype； - 检查字体文件：
think/captcha/assets/font/1.ttf是否存在且可读；推荐换用无版权的DejaVuSans.ttf并在配置中显式指定路径。
清除输出干扰，确保图像流纯净
只要验证码方法执行前有任何字符输出（空格、BOM、Warning、echo），图片就会变红叉或空白：
- 在验证码生成方法开头加
ob_clean();（不是ob_end_clean()）； - 关闭错误提示：
ini_set('display_errors', 'off');； - 用 VS Code 或 Sublime 打开所有 PHP 文件（尤其
index.php和验证码控制器），右下角确认编码是 UTF-8 without BOM； - 检查文件末尾有没有多余空行或空格 —— PHP 文件不应以
?>结尾，更不能在其后加换行。
验证 Session 是否生效
验证码值靠 Session 存储，Session 失效会导致生成空白、验证总失败：
- 确认
application/tags.php中app_init数组包含\think\middleware\SessionInit::class； - 写个测试：在控制器里执行
session('test', 'ok'); dump(session('test'));，输出null就说明 Session 未启动； - 检查
runtime/cache/captcha目录是否存在、可写（权限建议755或775）； - 确认
session.save_path（如/tmp）对 Web 进程用户（如www-data）可写。
前端请求与缓存处理
即使后端正常，前端也可能因路径或缓存导致“看不见”：
- 前端 img 的 src 应为
{:captcha_src()}，点击刷新时需加随机参数防缓存：<img src="%7B:captcha_src()%7D" onclick="this.src='{:captcha_src()}?'+Math.random()">； - 用浏览器开发者工具 → Network 标签，点击验证码图片，看响应头是否含
Content-Type: image/png，响应体是否为二进制乱码（而非 HTML 或 500 错误）； - 如果返回 404，检查伪静态规则是否正确匹配
/captcha路由；TP5.1 默认路由是index.php?s=captcha，别漏了index.php。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
