dede首页不显示图片-DEDE建站-盈思创科技

排查思路：从浏览器到数据库，从简单到复杂

我们遵循“先检查显示，再检查数据，最后检查配置”的原则。

（图片来源网络，侵删）

第一步：检查浏览器和网站访问问题

这是最基础的一步,确保问题不是出在您的电脑上。

清除浏览器缓存：
- 按 Ctrl + F5 (或 Cmd + Shift + R 在 Mac 上) 强制刷新页面，这可以清除本地缓存,加载最新的网页。
- 或者，在浏览器设置中清除缓存和Cookie,然后重新打开网站。
检查图片链接是否有效：
- 在首页上，右键点击那个不显示的图片，选择“在新标签页中打开图片链接”。
- 如果新标签页能正常显示图片，说明图片文件本身是存在的,问题出在网站代码或服务器配置上。
- 如果新标签页也打不开，或者显示“404 Not Found”，说明图片文件已经丢失或路径错误，请直接跳到 第五步。
使用无痕/隐私模式访问：
（图片来源网络，侵删）

打开浏览器的无痕窗口，访问网站首页，这样可以排除浏览器插件（如广告拦截器）的干扰，有些插件会误判图片为广告或恶意内容,从而阻止其加载。

第二步：检查DedeCMS后台内容和标签

如果缓存和链接都正常,那么问题很可能出在DedeCMS的内容或标签调用上。

检查文章内容中的图片：
- 登录DedeCMS后台,找到首页不显示图片的那篇文章。
- 进入文章编辑器（默认为ckeditor），检查图片标签，图片标签应该是这样的形式：
```
<img src='/uploads/202510/27/xxx.jpg' alt='图片描述' width='500' />
```
- 关键点：检查 src 属性中的路径是否正确，路径是否以开头（绝对路径）？路径中的文件名和文件夹名是否正确？有没有多余的空格或特殊字符？
- 常见错误：图片路径是相对路径（如 images/xxx.jpg），这在某些服务器配置下会导致路径解析错误,最好使用绝对路径。
检查首页调用文章的标签：
（图片来源网络，侵删）
- 首页通常是通过 {dede:arclist} 标签来调用文章列表的。
- 登录后台，进入“模板” -> “默认模板管理”，找到并编辑首页模板文件（通常是 index.htm）。
- 找到 {dede:arclist} 标签，检查它是否包含了 imglink 或 litpic 等字段来获取文章的缩略图。
- 一个常见的错误：标签中使用了 [field:imglink/]，但这个标签需要配合 {dede:arclist} 的 typeid 和 channelid 等属性正确使用，更常用的是 [field:litpic/] 来获取缩略图路径。
- 检查标签写法：
```
{dede:arclist typeid='1' row='8' titlelen='30'}
<li>
  <a href="[field:arcurl/]"><img src="[field:litpic/]" alt="[field:title/]" /></a>
  <a href="[field:arcurl/]">[field:title/]</a>
</li>
{/dede:arclist}
```
  确保你的模板代码中，img 标签的 src 属性正确地指向了 [field:litpic/]。

第三步：检查DedeCMS核心设置

如果标签没问题,那可能是DedeCMS的全局设置出了差错。

检查附件基本设置：
- 登录DedeCMS后台，进入“系统” -> “系统基本参数” -> “附件设置”。
- 找到 “(是/否)开启远程图片本地化”，确保此项设置为 “是”，开启此功能可以自动将外部图片下载到本地,避免因外部链接失效导致图片不显示。
- 检查 “(是/否)开启图片水印”，如果开启但水印图片路径错误,也可能导致图片无法正常显示。
- 检查 “附件目录”设置，确认附件（包括图片）上传的目录是否正确,并且该目录存在且有写入权限。
检查文档默认摘要图片：
- 在“系统基本参数”中，找到“文档默认摘要图片”的设置。
- 如果这里留空，且你没有为文章设置缩略图，那么文章列表就不会显示图片，你可以在这里设置一个默认的缩略图路径,或者确保所有被调用的文章都手动设置了缩略图。

第四步：检查服务器环境和权限

这是最容易被忽视,但也是最关键的一环。

检查目录权限：
- 通过FTP或服务器文件管理器，检查DedeCMS的 uploads 目录及其子目录（如 uploads/allimg/, uploads/202510/ 等）的权限。
- 这些目录的权限通常需要设置为 755，如果权限不正确,DedeCMS可能无法将图片写入或读取这些目录。
- 特别注意：检查 data 目录，它需要可写,因为DedeCMS的一些配置和缓存会存放在这里。
检查.htaccess文件：
- 在网站根目录下，检查是否存在 .htaccess 文件。
- 某些不正确的 Rewrite 规则可能会阻止图片等静态文件的访问，可以尝试将 .htaccess 文件重命名为 .htaccess.bak，然后刷新首页，看图片是否能正常显示，如果能，说明是 .htaccess 的问题,需要检查并修改其中的规则。
检查服务器安全软件：
- 如果您的服务器装有安全狗、云锁等安全软件，它们可能会误拦截对 uploads 目录的访问，请检查安全软件的日志，并将 uploads 目录加入白名单。

第五步：检查图片文件本身

如果以上步骤都无效,那问题可能出在图片文件上。

图片文件损坏：

通过FTP下载那个有问题的图片文件，尝试在本地电脑上打开，如果无法打开，说明文件在上传过程中损坏了,需要重新上传。
文件名或路径包含中文/特殊字符：

DedeCMS对中文文件名的支持有时不稳定，尽量使用英文、数字和下划线来命名图片文件和文件夹。
图片路径未入库：

极少数情况下，图片文件虽然上传成功了，但数据库中对应的记录没有正确更新路径，可以尝试在后台修改一下文章，重新上传一次缩略图，然后保存,这会重新更新数据库。

总结与快速排查清单

为了方便您快速定位问题,这里有一个简化的检查清单：

刷新页面：按 Ctrl + F5 强制刷新。
检查图片链接：右键图片 -> “在新标签页中打开”,看图片是否存在。
检查文章内容：进入后台编辑文章，看 img 标签的 src 路径是否正确。
检查首页模板：看 {dede:arclist} 标签中是否正确使用了 [field:litpic/]。
检查目录权限：确保 uploads 目录权限为 755。
检查.htaccess：临时重命名它,看问题是否解决。
重新上传图片：尝试删除旧图片,重新上传一个新图片。

按照这个流程，90%以上的“首页不显示图片”问题都能被解决，如果问题依然存在，请提供更具体的信息，是所有图片都不显示，还是特定文章的图片不显示？是缩略图不显示还是文章内容里的图片不显示？这将有助于更精确地定位问题。

dede首页不显示图片