核心思路:缩略图从生成到显示,需要经过“生成 -> 存储 -> 调用 -> 解析”四个环节,任何一个环节出问题,都会导致无法显示。
第一步:检查缩略图是否成功生成(源头问题)
这是最常见的问题,织梦(DedeCMS)的缩略图是在上传图片时,根据后台设置自动生成的,如果生成失败,后面的一切都无从谈起。

(图片来源网络,侵删)
检查目录权限: 这是首要检查项,织梦需要向服务器写入文件来生成缩略图。
- 目录位置:
你的网站目录/dedepic/和你的网站目录/uploads/ - 检查方法:
- 通过FTP或服务器文件管理器,右键点击这两个目录,查看权限。
- Linux服务器:权限必须为
755或775。dedepic目录内的子目录权限也需要检查。 - Windows服务器:确保 "IIS_IUSRS" 或 "Users" 用户组有“读取和写入”权限。
- 解决方案:如果权限不正确,请修改为正确的权限,如果还是不行,尝试在
dedepic目录下手动创建一个test.txt文件,看看是否能成功写入,以此来判断权限问题。
检查服务器函数支持:
织梦生成缩略图依赖 PHP 的 GD 库或 Imagick 扩展。
- 检查方法:
- 在织梦后台,进入“系统” -> “系统基本参数” -> “核心设置”,找到“是否使用GD库或Imagick进行图片处理”。
- 如果你的服务器支持
GD,就选择是,如果支持Imagick且性能更好,可以选择Imagick。 - 你也可以创建一个
phpinfo.php文件,内容为<?php phpinfo(); ?>,上传到网站根目录访问,在页面中搜索 "GD" 和 "Imagick",看是否已安装并启用。
- 解决方案:如果服务器不支持,需要联系你的主机商开启相应的扩展。
检查图片上传和生成规则:
- 检查方法:
- 进入后台“系统” -> “系统基本参数” -> “附件设置”。
- 查看“缩略图默认宽度”和“缩略图默认高度”是否设置为了0,如果为0,织梦将不会生成缩略图,请设置一个合适的值,
200。 - 检查“缩略图保存目录”,确保目录存在且可写(与第一步相关)。
- 解决方案:将缩略图宽高设置为非0值,并确保保存目录正确。
检查图片本身问题:

(图片来源网络,侵删)
- 检查方法:尝试上传不同格式的图片(如
.jpg,.png,.gif),有些损坏的图片或者特殊格式的图片(如.webp,旧版本织梦不支持)可能导致生成失败。 - 解决方案:换一张正常的图片试试。
第二步:检查缩略图路径是否正确(存储和调用问题)
即使缩略图生成了,如果后台或前台调用的路径错误,同样无法显示。
后台列表页缩略图不显示:
- 问题原因:通常是织梦的缓存问题。
- 解决方案:
- 进入后台“系统” -> “一键更新网站” -> “更新HTML” -> “更新文档HTML”,点击“开始更新”。
- 或者,在后台“系统” -> “缓存管理”中,清空所有缓存,然后刷新后台页面。
前台页面缩略图不显示(路径错误):
- 问题原因:网站域名变更、服务器迁移、或织梦的全局变量配置错误,导致缩略图的调用路径是绝对路径(如
D:/wwwroot/...)而不是相对于域名的路径(如/uploads/...)。 - 检查方法:
- 在后台“系统” -> “系统基本参数” -> “核心设置”中,检查“网站根网址”是否正确。
- 检查“附件目录”,确保是相对于网站根目录的路径,如
uploads。
- 解决方案:
- 修复绝对路径:这是最常见的原因,织梦在生成内容时,有时会把图片路径写死为服务器的绝对路径。
- 方法一(推荐):使用织梦的SQL命令批量修复。
- 进入后台“系统” -> “SQL命令行工具”。
- 在“运行SQL文件”或“多行命令”中,执行以下命令(请务必先备份数据库!):
-- 修复文章body中的图片路径 UPDATE dede_archives SET body = REPLACE(body, 'src="/uploads/', 'src="/你的网站/uploads/'); -- 修复文章body中的图片路径(另一种可能) UPDATE dede_archives SET body = REPLACE(body, 'src="D:/你的网站目录/', 'src="/你的网站/'); -- 修复附加表中的缩略图路径 UPDATE dede_addonarticle SET litpic = REPLACE(litpic, 'uploads/', '/你的网站/uploads/'); -- 修复主表中的缩略图路径 UPDATE dede_archives SET litpic = REPLACE(litpic, 'uploads/', '/你的网站/uploads/');
- 请务必将命令中的
/你的网站/替换成你自己的网站实际路径, 或者/blog/等,如果不确定,可以先在数据库里找到一条记录,看看错误的路径是什么样的,然后针对性地用REPLACE函数替换。
- 方法二:重新发布或编辑有问题的文章,让织梦按照新的路径规则重新生成内容。
- 方法一(推荐):使用织梦的SQL命令批量修复。
- 修复绝对路径:这是最常见的原因,织梦在生成内容时,有时会把图片路径写死为服务器的绝对路径。
第三步:检查前台模板调用(解析问题)
缩略图已经生成,路径也正确,但模板代码写错了,导致浏览器无法解析。

(图片来源网络,侵删)
检查模板标签:
- 文章列表页:通常使用
{dede:list}或{dedarclist}标签,里面调用缩略图的标签是[field:litpic/]。 - 页:通常使用
{dede:field name='litpic'/}。 - 检查方法:检查你的模板文件(如
list_article.htm,article_article.htm)中,调用缩略图的标签是否写错,写成了[field:picname/](这是图片alt文本)或者其他不存在的标签。
检查图片标签的属性:
- 问题原因:
src路径正确,但图片标签本身有错误。 - 检查方法:在前台页面,右键点击不显示的缩略图,选择“检查元素”,查看浏览器解析出的HTML代码。
src属性是空的或者有误,说明是模板标签问题。src属性是正确的,但图片就是加载不出来,可能是图片文件本身不存在(虽然路径对,但文件被删除了)或者服务器配置问题(如.htaccess规则阻止了访问)。
总结与排查流程
当你遇到“织梦缩略图不能浏览”的问题时,请按照以下顺序进行排查:
-
【第一步】检查生成
- 1 目录权限:
/dedepic/和/uploads/是否为755?IIS用户是否有写入权限? - 2 GD库/Imagick:后台是否开启?服务器是否支持?
- 3 后台设置:缩略图宽高是否为0?是否设置了保存目录?
- 4 图片文件:尝试换一张图上传。
- 1 目录权限:
-
【第二步】检查路径
- 1 后台缓存:清空后台缓存,更新文档HTML。
- 2 全局变量:检查“网站根网址”和“附件目录”是否正确。
- 3 修复绝对路径:使用SQL命令批量替换数据库中的图片路径,将其改为网站相对路径。
-
【第三步】检查模板
- 1 模板标签:确认调用缩略图的标签(如
[field:litpic/])是否正确。 - 2 浏览器检查:使用“检查元素”功能,分析HTML代码,定位问题所在。
- 1 模板标签:确认调用缩略图的标签(如
按照这个流程,90%以上的缩略图问题都能被找到并解决,如果以上步骤都无法解决问题,那么很可能是服务器环境或程序文件本身有损坏,可以考虑重新上传一份干净的织梦程序文件(覆盖除 /data 目录外的所有文件)来尝试修复。
