Dedecms图片在二级域名附件设置后无法正常显示的根本原因解析

Dedecms作为一款广受欢迎的内容管理系统， 在绑定二级域名进行附件目录设置时常见的问题之一就是文章中的图片无法正常显示。这主要源于路径引用的问题。默认情况下 Dedecms生成的图片路径是相对路径，当你绑定了二级域名后相对路径指向位置发生变化，导致浏览器请求不到正确的图片资源。

简单 就是“域名变了但图片链接还是旧的相对路径”所以造成了404错误或者空白图像。

为什么要使用二级域名绑定附件目录？

使用二级域名绑定附件目录有以下几个优势：

• 独立分离静态资源：减轻主站压力，提高加载速度。
• 利于CDN加速：便于单独配置CDN缓存策略。
• 平安隔离：防止某些恶意请求影响主站点。

但由于Dedecms默认设计并没有完全兼容这种场景， 所以需要进行额外设置和代码调整，才能保证图片正常显示。

官方提供的两大关键配置选项详解

在Dedecms后台——系统参数设置——其它选项中， 有两个与二级域名附件相关的重要配置：

1. 附件目录是否绑定为指定的二级域名
2. 附件目录的二级域名地址

开启第一个选项并填写第二个选项后系统将尝试把附件调用改为绝对URL，按道理讲可以解决部分图片访问问题。

实操建议：

• 确认这两个配置均已正确启用和填写。
• 清理缓存后再测试页面效果。

为何仅靠官方参数仍不能彻底解决问题？技术原理剖析

DedeCms内部生成文章内容的时候， 很多时候会存储相对路径，这使得导致资源找不到。

还有啊， 一些模板或核心函数生成缩略图、列表页展示时也没有统一使用带有完整URL前缀的路径，导致多处调用失效。

DedeCms中涉及关键文件及代码位置举例：

• /include/inc_arclist_view.php 第594行附近 —— 图片路径处理逻辑
• /include/inc/inc_fun_spgetarclist.php 第195行 —— $row赋值操作
• /include/dialog/select_* 系列文件 —— 附件选择器处理

dedecms图片在二级域名附件设置后如何修改实现正常显示？妙招全解析！

1. 开启多站点支持与绝对网址功能

- 登录后台：系统 - 系统设置 - 核心设置 - 找到“是否支持多站点”， 选择“是” - 找到“是否启用绝对网址”，也选择“是” - 保存设置，并清空缓存 此举确保后台输出的链接都会以完整URL形式出现，不再是相对路径，从根本上避免因不同子域而导致访问失败的问题。

2. 修改核心文件确保获取绝对路径

- 打开/include/inc_arclist_view.php, 找到第594行左右包含类似如下代码的位置：

$row = $row . $row;

- 将该行替换成下面代码：

// 判断是否开启了附件目录绑定
if  {
    $addon_domain = $GLOBALS;
} else {
    $addon_domain = $row;
}
$row = $addon_domain . $row;

- 同样方法适用于其他调用图片变量赋值的位置， 比如/include/inc/inc_fun_spgetarclist.php 第195行附近.

*此修改可以强制让所有调用得到的是完整且正确的URL地址，从而避免因基于当前访问子域拼接造成的错误问题。

3. 在模板中统一调用绝对链接， 避免混用相对地址导致不稳定显示效果

• 检查你的模板文件，重点看所有涉及文章内容及缩略图输出处是否存在硬编码或相对引用，比如：
• 推荐 为： 或者直接输出后的绝对链接变量。如遇自定义标签，请按文档调整输出格式。
• 避免手动拼接或直接写死相对地址；建议完全依赖程序自动生成后来啊以保证跨子站兼容性。
• 注意检查分页组件、推荐位等模块，同样可能存在未处理好的相对链接。
• 充分利用, 获取最新模板语法和最佳实践。

4. 使用软连接提高服务器资源共享效率

如果你的服务器支持Linux命令，可以通过软连接方式解决物理上传目录不一致问题。比方说 将你的/uploads/映射到二级子站点根目录下：

ln -s /var/www/html/uploads /var/www/subdomain/uploads
// 注意根据你的实际网站根目录调整命令中的路径
// 确保权限与所有者允许web服务读取 
 

这样，在浏览器访问http://sub.yoursite.com/uploads/xxx.jpg 时会实际映射至主站上传文件夹，实现无缝访问。这种方式成本低，无需改动程序核心，但只适用于你能控制服务器环境且熟悉命令操作的人士。

案例分享：小李成功修复dedecms附件二级域名图片不显示问题全过程回顾  🛠️📸  📁  💡

• 背景: 小李将公司官网静态资源迁移至cdn.yourdomain.com后发现文章详情页内上传图片全部无法加载 。
• 排查 : 先说说确定后台已开启 “ 附件绑定为指定 二 級 域 名 ” ， 接下来检查数据库中存储 图片 路径均为 相對路徑 ，导致客户端请求错误 。                                                                     　　 　　 　　　 　　 　　　 　　　 　 　　　 　　　　 　 　　　 　　　　　　 　　 　　　　　　 　　　　　　 　 　　
• 修改 : 按照本文提议，把include/inc_arclist_view.php 和 include/inc_fun_spgetarclist.php 中对应变量赋值替换成带有$addon_domain前缀 的 完整 URL 。同時更新模板 图片 标签 输出方式确保调用完整url 。 　 　 　　　　　　　 　　 　　　　　 　 　　　　　　　　　　 　　　　 　　　 　 　　　　 　　　　　 　　　　　　 　 　　　　　 　　　　　　 　 　　　　　　　 　　

---

| Dedecms在使用二级域名绑定附件目录后的最佳实践清单 ✅✅✅

• 务必先在后台开启“ 支持多站点 ”及“ 启用绝 对网址 ” 两项基本功能 。这是解决问题 的第一步，也是非常关键的一步 。                                　　　　　　 　　　　　　　 　　　　　　　　　　　　　　　　 　　　　　　　　　　 　　　 　　　　　　　 　　　　　　　 　　　　　　　 　　　　　　 　　　　 　　　　　 　　　　 　　　　　 　　　　　 　　　　　　　　　　　　　　　　　 　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　 　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　 　　　　　　　 　　　　　　　　　　 　　 　　　　　　　　　　　　　 　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　 　　　　　　　 　　　　　　　　　 . . . . . . . 。 。 。 。 。 。 。 。 。 。 。 。 。 。 。 。 。 。 。 。 。 。 。

---