captcha_img() 输出空白的根源是响应体被污染或gd/session/扩展配置异常，需依次排查utf-8 bom、空行、错误输出、gd扩展启用与权限、session中间件启用、think-captcha正确安装。
captcha_img() 输出空白，本质是响应体被污染
不是验证码“坏了”，而是它前面混进了不可见字符——最常见的是 UTF-8 BOM 头、文件末尾的空行、echo 或错误提示。图像响应必须是纯二进制流，任何前置文本都会让浏览器拒绝解析。
验证方式很简单：用浏览器直接访问验证码 URL（如 /captcha?_=123），右键「查看网页源代码」。如果开头不是乱码或空白，而是能看到 PNG 以外的字符（比如 Warning:... 或一堆空格），就坐实了输出污染。
- 所有控制器方法、配置文件、中间件类，保存为 UTF-8 无 BOM 格式（VS Code / PHPStorm 默认就是，Notepad++ 需手动选）
- 入口文件
public/index.php和验证码调用处前后不能有空行、空格、var_dump - 临时关闭错误显示：
ini_set('display_errors', '0');放在验证码生成逻辑前 - 最省事兜底方案：
ob_clean();必须紧挨着captcha_img()或new Captcha()->entry()前调用
GD 扩展未启用或配置异常
captcha_img() 底层依赖 GD 绘图，但 PHP 启动时没加载 GD，或者虽加载了却缺字体/临时目录权限，就会静默失败——不报错，只返回空响应。
别只看 phpinfo() 里有没有 GD 模块名，要确认它真能干活：
- 运行
php -m | grep gd，有输出才算启用 - 检查
php.ini中extension=gd是否取消注释；Windows 下可能是extension=php_gd2.dll - GD 需要写入临时目录生成缓存，确认
sys_get_temp_dir()返回路径可写（Linux 下常为/tmp） - ThinkPHP 8 默认用 PNG，若服务器禁用了
imagepng()（如 GD 编译时没带 zlib），会 fallback 失败——可临时改配置'type' => 'jpeg'测试
Session 中间件未生效，导致校验值根本没存进去
验证码图像能显示，但 captcha_check() 恒返回 false，大概率是 Session 没真正启动。TP8 不再自动初始化 Session，靠中间件驱动，漏配或顺序错都会断链。
检查点很具体：
- 打开
app/middleware.php，确认\think\middleware\SessionInit::class在$middleware数组中且未被注释 - 不要在控制器里写
session_start()—— 它和框架 Session 机制冲突，反而清空 session_id - 快速验证：在任意接口里写
session('test', 'x'); var_dump(session('test'));，输出string(1) "x"才算通 - 注意跨域/子域场景：前端请求带的
Cookie: PHPSESSID=xxx，后端收到的 session_id 必须和生成验证码时一致；Nginx 反向代理需透传Cookie头
think-captcha 扩展未正确安装或版本错配
TP8 不再内置验证码，captcha_img() 是扩展提供的函数。Composer 安装失败、autoload 未刷新、或装了旧版，都会导致函数不存在或行为异常。
执行这些动作排除：
- 运行
composer require topthink/think-captcha（TP8 用最新版，别加=2.*这类约束） - 确认
vendor/topthink/think-captcha/src/Captcha.php文件存在且可读 - 运行
composer dump-autoload -o强制刷新自动加载映射 - 如果之前装过 TP5 的
think-captcha，先composer remove topthink/think-captcha再重装，避免命名空间冲突 - 检查
config/captcha.php是否存在；若没有，复制vendor/topthink/think-captcha/config/captcha.php到项目 config 目录下
真正卡住人的往往不是某一步没做，而是几处小问题叠在一起：BOM 头让图像流损坏，GD 缺少写权限又让 fallback 失败，Session 中间件没启导致验证码值压根没存——结果你盯着一个现象调三天，其实每步都差一点。动手前，先用浏览器直连验证码 URL 看原始响应，比猜原因快十倍。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
