dede调用多张图片为何不显示？-DEDE建站-盈思创科技

问题根源分析

在解决问题之前,我们先要明白DedeCMS是如何处理多张图片的。

（图片来源网络，侵删）

数据存储：多张图片通常被合并成一个字符串，用分隔，并存储在文章内容表的某个字段里，body（文章正文）或者你自定义的 picarr（图片集字段）。
标签调用：你需要使用特定的DedeCMS标签（如 {dede:imglist} / {dede:productimagelist}）来解析这个字符串。
路径解析：标签解析出的只是图片的文件名（如 uploads/image/20251010/123.jpg），DedeCMS需要将其拼接成完整的、可访问的URL（如 http://www.yoursite.com/uploads/image/20251010/123.jpg）。

任何一个环节出错,都会导致图片无法显示。

请按照以下步骤逐一排查,90%的问题都能在这里找到答案。

这是最常见的原因,调用多张图片必须使用正确的列表标签，而不是单张图片标签。

错误标签（用于单张图片）：
（图片来源网络，侵删）
- {dede:field name='litpic'/} 或 {dede:field.image/}：这两个标签只能调用文章的“缩略图”或“多图集的第一张图”，无法调用后续的图片。
正确标签（用于多张图片）：
- 页（article_article.htm）中调用：使用 {dede:imglist} 或 {dede:productimagelist} 标签，这两个标签通常需要放在 {dede:field.body/} 的内部，或者在你自定义的模板中直接使用。
  
  示例代码：
```
{dede:imglist}
<a href="[field:imgsrc function='str_replace("~","",$fields[imgsrc])'/]" target="_blank">
    <img src="[field:imgsrc function='str_replace("~","",$fields[imgsrc])'/]" alt="[field:text/]" width="200" />
</a>
{/dede:imglist}
```
  注意：[field:imgsrc] 里的路径有时会包含一个符号，代表网站根目录。function='str_replace("~","",$fields[imgsrc])' 这个函数的作用就是去掉，使其成为标准路径，如果你的图片路径没有，可以简化为 [field:imgsrc/]。
  （图片来源网络，侵删）
- 在列表页（如 list_article.htm）中调用多图：列表页调用多图比较复杂，通常需要结合自定义函数，最简单的方法是只调用第一张图（即缩略图）：
```
<img src='{dede:field name='litpic'/}' />
```
  如果一定要在列表页调用所有图片,可以参考下面的“自定义函数”方法。

很多人以为在编辑器里多插几张图就行,但对于“图集”类型的内容，需要特殊处理。

方法A：使用“图集”模型发布文章
1. 在后台新增文章时,选择模型为“图集”。
2. 在编辑器下方,会有一个“图集管理”或“多图上传”按钮。
3. 点击它,批量上传你的图片，并为每张图填写“标题”和“说明”。
4. 保存后,这些图片信息会以特定格式存入数据库。
方法B：在文章正文中上传图片（不推荐用于图集）
1. 使用编辑器（如ckeditor）的图片上传功能。
2. 上传多张图片后,这些图片的 <img> 标签会直接插入到 body 字段中。
3. 这种方式 {dede:imglist} 也能识别，但不如“图集”管理规范。

检查点：去后台 -> 内容 -> 内容维护 -> 选择一篇有问题的文章 -> 查看源码或图集管理，确认图片确实存在并且路径正确。

这是导致图片不显示的“罪魁祸首”，图片路径分为“相对路径”和“绝对URL”。

问题现象：右键点击图片，选择“检查”，发现 src 属性是一个错误的路径，/~uploads/image/... 或者 /data/admin/... 等。
解决方案：
1. 检查系统基本参数：进入后台 -> 系统 -> 系统基本参数 -> 核心设置。
  - “站点根目录URL”：确保这里填写的是你的网站域名，如 http://www.yoursite.com，结尾不要加斜杠。
  - “附件目录”：确认附件上传目录是否正确，通常是 /uploads。
  - 保存后,更新网站缓存（后台右上角“生成” -> “更新系统缓存”）。
2. 使用路径修正函数（最有效）：如第1步的代码所示，在标签里使用 function='str_replace("~","",$fields[imgsrc])' 来修正路径，这是DedeCMS的经典做法，务必确保你的标签里包含了它。
3. 检查 include/helpers/channelunit.helper.php 文件：这个文件负责路径解析，检查其中的 ReplaceSavePath 函数是否存在且未被修改，如果这个文件丢失或损坏，路径解析就会失败。

如果你使用了自定义的字段来存储图片（picarr），需要确保标签和字段名对应。

检查模型：后台 -> 核心 -> 内容模型管理 -> 查看你使用的模型，确认是否有“图片集”字段，以及字段的参数设置是否正确。
检查标签：如果图片存储在自定义字段 picarr 中，你可能需要自定义一个函数来解析它，或者使用 {dede:field name='picarr'/} 直接输出原始数据来调试，看看是否能得到类似 a.jpg|b.jpg|c.jpg 这样的字符串。

目录权限：确保你的图片上传目录（如 /uploads）及其子目录具有正确的读写权限（通常是755或754），你可以通过FTP或主机控制面板检查和修改。
文件是否存在：通过FTP登录你的服务器，根据数据库里存储的图片路径，找到对应的文件，确认它确实存在且没有被损坏。

如果以上方法都不能解决问题,请按以下流程进行终极排查：

简化测试：新建一篇文章，使用“图集”模型，只上传一张图片，然后调用 {dede:imglist} 看看是否能显示，如果能，说明问题出在你之前那篇文章的数据上，如果还是不能，说明是系统或模板的普遍问题。
输出原始数据：在模板中，使用 {dede:field.body/} 或 {dede:field name='picarr'/} 直接输出原始内容，查看源码，找到图片的 <img> 标签，看看 src 属性到底是什么。
- src 是空的或乱码，说明数据没存进去或存错了（问题在第2步）。
- src 是一个完整的、正确的URL，但图片就是不显示，那100%是服务器权限或网络问题（问题在第5步）。
- src 是一个错误的路径（如带或不完整），说明路径解析失败（问题在第3步）。
查看服务器错误日志：如果网站开启了错误日志，查看 error_log 文件，里面可能会有关于图片读取失败的详细错误信息（如 Permission denied 权限被拒绝，或 file not found 文件未找到）。

通过以上系统性的排查,你一定能定位并解决DedeCMS多图不显示的问题，希望这份详细的指南能帮到你！