迅睿CMS缩略图不显示修复实操步骤
步骤1：验证并开启PHP GD库（核心依赖）
迅睿CMS缩略图依赖GD库生成，若未开启将直接导致缩略图无法生成。操作： 1. 在网站根目录新建名为phpinfo.php的文件，写入代码： ``` ``` 2. 访问「你的域名/phpinfo.php」，在页面中搜索关键词「gd」，若未出现GD模块相关信息，说明GD未开启。 3. 找到PHP配置文件php.ini（常见路径：Linux为/usr/local/php/etc/php.ini，Windows为XAMPP的php目录下php.ini），搜索`;extension=gd`，删除前面的分号（;），保存文件。 4. 重启PHP服务：Apache执行`systemctl reload httpd`，Nginx+PHP-FPM执行`systemctl reload php-fpm`。 5. 重新访问phpinfo.php确认GD已加载。
步骤2：核对迅睿CMS后台缩略图配置
登录迅睿CMS后台，依次进入「内容→内容模型管理→对应内容模型（如文章模型）→字段管理」，找到缩略图字段（默认字段名为thumb），点击「修改」： 1. 确认「缩略图生成宽度」「缩略图生成高度」参数不为0或过大（建议设置为150-800之间的数值，如200×200）； 2. 进入「设置→附件设置」，检查「缩略图存储路径」为web可访问的路径（如public/uploads/thumb，避免使用private目录）。
步骤3：修正缩略图目录权限
若GD已开启但仍不显示，大概率是目录权限不足无法写入生成的缩略图。操作： 1. 通过SSH或FTP进入网站根目录，找到缩略图存储目录`public/uploads/thumb`； 2. 执行权限修复命令： Linux环境： ``` chmod -R 755 public/uploads/thumb chown -R www-data:www-data public/uploads/thumb ``` Windows环境： 右键该文件夹→属性→安全，将当前用户权限设置为「完全控制」。
步骤4：清空旧缩略图缓存
旧缩略图缓存可能导致新配置不生效，需清空后重新生成。操作： 登录后台，进入「工具→缓存管理」，勾选「缩略图缓存」，点击「清空缓存」； 若为批量内容问题，可进入「内容→内容管理」，批量选中对应内容，点击「批量操作→更新缩略图」，重新生成所有内容的缩略图。
步骤5：修正模板中缩略图调用标签
模板标签调用错误是前端显示失败的常见原因。迅睿CMS正确的缩略图调用标签为： ``` {dr_thumb($内容字段名, '尺寸')} ``` 示例（文章内容的缩略图，尺寸为200）： ``` {dr_thumb($t.thumb, '200')} ``` ⚠️ 错误写法：无尺寸参数的`{dr_thumb($t.thumb)}`，若后台设置的默认尺寸未生效，将直接调用失败；同时确认模板文件路径为「templates/你的主题名/对应内容模板」（如templates/default/content/article.html），避免修改错模板文件。
步骤6：排查服务器伪静态规则
若缩略图返回404错误，需检查伪静态规则： 1. Nginx服务器：在Nginx配置文件的对应server块中添加： ``` location ~ ^/public/uploads/thumb/ { expires 30d; access_log off; } ``` 替换完整的迅睿官方Nginx伪静态规则可从后台「设置→系统设置→伪静态规则」获取，或访问下载：https://xincms.com/download/rewrite.zip，解压后覆盖网站根目录的Nginx配置文件。 2. Apache服务器：确认网站根目录的`.htaccess`文件存在且完整，缺失可从上述地址下载对应文件覆盖。
最终验证
完成以上步骤后，上传一篇带缩略图的新内容，前后端查看缩略图是否显示。若仍失败，查看PHP错误日志（Linux路径：/var/log/php-fpm.log），搜索「gd」「file permission」等关键词，根据日志调整对应配置。
