自己做的网站验证码出不来怎么回事
本文关键词：自己做的网站验证码出不来怎么回事
干了十五年建站，我见过太多小白折腾半天，最后卡在验证码这个鬼环节上。昨天有个哥们儿私信我，急得跟热锅上的蚂蚁似的，说他自己写的后台登录页，图片验证码死活不显示，白框框在那儿，急得想砸电脑。我让他截图，他说没图，我就大概猜到了原因。这玩意儿真不是玄学，就是代码逻辑或者服务器配置那点事儿。
首先，你得搞清楚，验证码不是凭空变出来的，它是服务器算出来，传给你，浏览器再画出来的。如果它不显示，大概率是这三个地方出了问题。
第一，也是最常见的，路径错了。很多新手写代码，喜欢用相对路径，比如 src="captcha.php"。结果呢？你本地测试好好的，一传到服务器，目录结构稍微有点变化，或者伪静态规则一开，这个路径就找不着北了。浏览器请求这个图片，服务器返回404，浏览器当然不给你画图了，就留个白框。这时候你打开浏览器的开发者工具（F12），看Network标签页，那个验证码请求是不是红色的404？如果是，赶紧检查你的图片生成脚本路径，或者干脆用绝对路径，比如 /static/images/captcha.png，虽然稍微麻烦点，但稳妥。
第二，权限问题。这点特别容易被忽略。你写的验证码生成脚本，比如 captcha.php，或者生成的图片文件，服务器有读取权限吗？有些服务器为了安全，默认禁止执行PHP文件，或者禁止访问某些目录。特别是如果你用了Linux服务器，chmod权限没设对，比如设成了600，Web服务器用户（比如www-data）读不了，那肯定出不来。还有，有些空间商为了防攻击，禁用了GD库或者ImageMagick，这两个是生成验证码图片的核心库。如果你的环境没装这些，代码跑起来直接报错，图片自然生成不了。这时候你得联系你的主机商，问清楚他们支持不支持GD库，或者自己检查phpinfo()页面，看看gd模块有没有加载。
第三，缓存捣鬼。这个最坑人。你改完代码，上传了，刷新页面，还是老样子。为什么？因为浏览器或者服务器缓存了你的旧验证码图片。特别是CDN，如果你开了CDN，它可能把那个不存在的图片或者旧的错误图片缓存了。这时候你得强制刷新，Ctrl+F5，或者在浏览器里清缓存。如果还不行，检查你的CDN配置，把验证码相关的URL加入排除列表，不让它缓存。
还有个隐蔽的坑，就是字体缺失。验证码图片上那些扭曲的字母，是用字体渲染的。如果你的服务器是精简版的Linux，比如Alpine Linux，或者某些云主机，可能没安装中文字体或者特定的英文字体。代码里指定了字体，但系统找不到，渲染失败，图片就可能是空的或者乱码。这时候你得去服务器里装个字体包，比如 yum install fontconfig 之类的，或者在代码里指定一个系统默认有的字体，比如 Arial。
我见过一个案例，一个朋友做了个企业站，验证码死活出不来，排查了两天，最后发现是Nginx配置里，location ~ .*\.(php|php5)?$ 这一行，把PHP请求给拦截了，导致验证码图片无法通过PHP生成。这种配置错误，新手根本想不到。所以，别光盯着代码看，服务器配置也得检查一遍。
总之，自己做的网站验证码出不来怎么回事？别慌，一步步排查。先看网络请求，再看服务器权限和环境，最后看缓存和字体。别听那些卖模板的瞎忽悠，说是要花钱买插件，其实多半是你自己配置没弄对。建站这事儿，就是细节决定成败，多试几次，总能搞定。实在搞不定，找个懂行的帮你看一眼，比你自己瞎琢磨强得多。记住，别为了省那点调试时间，最后搞出一堆bug，得不偿失。
