Drupal新安装后文章图片无法生成缩略图，日志报imagesx()参数错误

这个报错我碰到过好多次，核心原因就是Drupal调用PHP的imagesx()函数时，传入的图片资源是null——说白了就是系统没法正确读取或者处理你上传的图片文件。下面给你几个实用的排查和解决步骤：

• 检查PHP GD扩展是否启用
  Drupal生成缩略图完全依赖GD库，先确认它有没有装好。你可以登录Drupal后台，进入状态报告页面（路径是/admin/reports/status），找到GD库相关的条目，看是不是显示“已启用”。如果没装，根据你的服务器系统操作：

  • Ubuntu/Debian系统：执行sudo apt-get install php-gd
  • CentOS/RHEL系统：执行sudo yum install php-gd
    安装完成后记得重启Web服务器，比如Apache用sudo systemctl restart apache2，Nginx用sudo systemctl restart nginx。

• 修复文件目录权限
  上传的图片和缩略图存储目录权限不对，会导致系统没法读写。默认情况下，Drupal的文件存储目录是sites/default/files，下面的styles子目录专门存缩略图。你可以用命令调整权限：

  1. 把目录所有者改成Web服务器用户（通常是www-data或者apache）：chown -R www-data:www-data sites/default/files
  2. 设置目录权限为755，文件权限为644：

     find sites/default/files -type d -exec chmod 755 {} \;
     find sites/default/files -type f -exec chmod 644 {} \;
     

• 验证上传图片的完整性
  有时候问题出在图片本身——比如上传的文件损坏、格式不兼容。你可以换几张确定没问题的图片（比如系统自带的测试图片）试试，如果能正常生成缩略图，那就是之前的图片文件有问题，重新导出或下载正常的图片再上传就行。

• 提高PHP内存限制
  处理大尺寸图片时，PHP内存不够会导致GD库无法创建图片资源。你可以这么调整：

  1. 打开php.ini文件，找到memory_limit项，改成128M或更高（比如256M），保存后重启Web服务器。
  2. 也可以在Drupal的settings.php文件末尾添加一行：ini_set('memory_limit', '256M');，临时提升内存限制。

• 检查图片样式配置
  可能是图片样式的设置出了问题。进入/admin/config/media/image-styles，找到你使用的图片样式（比如默认的thumbnail），确认尺寸设置都是正整数，并且添加了正确的效果（比如“缩放”“裁剪”）。试着重新保存一下样式，再上传图片测试。

• 清除Drupal缓存
  旧缓存可能导致配置不生效，进入/admin/config/development/performance页面，点击“清除所有缓存”；如果装了Drush工具，也可以直接执行drush cr命令快速清除缓存。

如果以上方法都没用，建议查看服务器的PHP错误日志，里面会有更详细的报错信息，比如是不是GD库不支持你上传的图片格式（比如WebP），针对性解决就行。

内容的提问来源于stack exchange，提问作者Catherina