织梦DedeCMS图片上传失败全场景排查解决实操指南 零基础可直接落地

前置快速排查（1分钟定位大致原因）

本指南适配织梦V57 UTF8/GBK主流版本，其他版本可参考操作，首先完成2项基础排查：

1. 图片本身合规性检查

优先检查3项属性：格式是否为织梦默认支持的jpg/png/gif/webp；单图大小是否超过默认2MB限制；命名是否包含中文、空格、括号、@等特殊字符。若存在以上问题，直接将图片重命名为纯英文+数字组合，压缩大小到2MB以内后重新上传测试。

2. 后台基础配置检查

登录织梦后台，进入系统->系统基本参数->附件设置，检查2项配置：允许上传的图片扩展名是否包含你需要上传的格式，默认配置为jpg|gif|png|webp，缺失对应格式直接补充即可；附件上传大小限制默认值为2048（单位KB），需要更大上传额度可直接修改数值，比如填10240即支持最大10MB单图，修改后点击保存。

核心故障场景&落地解决步骤

场景1：上传时提示“文件类型不正确”

该问题为织梦内置上传类的校验逻辑bug，PHP7.1+版本触发概率极高，按以下步骤修复： 1. 进入网站根目录，找到include/upload.class.php文件，下载到本地做备份 2. 打开文件找到第128行左右的原有代码： ``` if (!preg_match("\.(".$this->config['att_typ']."$)i", $filename)) ``` 3. 替换为以下修复后的代码： ``` $file_ext = strtolower(trim(substr(strrchr($filename, '.'), 1, 10))); if (!in_array($file_ext, explode('|', strtolower($this->config['att_typ'])))) ``` 4. 保存文件时注意：GBK版本编码选择ANSI/GBK，UTF8版本编码选择UTF-8无BOM，上传覆盖原文件后立即生效。

场景2：上传时提示“上传目录没有写权限”

该问题为服务器目录权限配置错误，按服务器环境对应操作：

• Linux/CentOS/宝塔面板环境：宝塔用户直接进入网站->对应站点->设置->权限，运行用户设为www，再进入文件管理找到uploads目录，右键设置权限为755，勾选“应用到子目录和文件”后确认。非面板用户登录SSH执行以下命令（路径替换为你实际的站点根目录路径）： ``` chown -R www:www /www/wwwroot/你的站点根目录 chmod -R 755 /www/wwwroot/你的站点根目录/uploads ```
• Windows/IIS环境：找到站点根目录下的uploads文件夹，右键点击「属性->安全->编辑->添加」，添加IIS来宾用户（IUSR_你的服务器名），给该用户赋予“读取、写入、修改”权限，点击确定后生效。

场景3：上传进度条走完无提示、图片不显示

该问题为PHP配置上传限制低于你设置的织梦后台限制，按以下步骤修复： 1. 在网站根目录新建phpinfo.php文件，写入以下代码： ``` ``` 2. 访问你的域名/phpinfo.php，查看三个参数的数值：upload_max_filesize（单文件上传最大值）、post_max_size（POST请求最大提交值）、max_execution_time（脚本最大执行时间） 3. 宝塔用户进入软件商店->已安装->对应PHP版本->设置->上传限制，将上传最大值调整为你需要的数值（比如10M），执行时间改为300秒，保存后重启PHP即可。自行搭建PHP环境的用户找到php.ini文件，修改以下配置： ``` upload_max_filesize = 10M post_max_size = 10M max_execution_time = 300 ``` 修改完成后重启PHP-FPM或Apache/Nginx服务，操作完成后务必删除phpinfo.php文件，避免泄露服务器配置信息。

场景4：后台上传成功、前端页面图片不显示

该问题为站点路径配置错误，按以下步骤修复： 1. 登录织梦后台，进入系统->系统基本参数->核心设置，站点根网址填写完整的站点域名，比如https://www.xxx.com，末尾不要加斜杠 2. 进入系统->系统基本参数->附件设置，附件保存路径保持默认值uploads即可，不要修改为绝对路径 3. 进入生成->更新系统缓存，点击“执行”后重新生成所有站点页面，即可正常显示图片。

特殊冷门场景解决

1. 安全插件/防火墙拦截上传

若安装了织梦官方安全插件、第三方防护插件或服务器防火墙，会默认拦截上传请求，进入后台模块->模块管理，临时禁用安全类插件后测试上传，确认是插件拦截后，将/uploads目录加入插件白名单即可。

2. CDN/Nginx反向代理拦截

使用CDN的用户进入CDN控制台，找到“上传大小限制”配置项，调整为你需要的数值即可。使用Nginx反向代理的用户，打开站点Nginx配置文件，在server块中加入以下配置： ``` client_max_body_size 10m; ``` 保存后重启Nginx生效。

最终验证操作

所有配置修改完成后，按照以下步骤验证： 1. 准备一张测试图片：命名为纯英文+数字、大小不超过你设置的上传限额、格式为jpg 2. 进入织梦后台附件->上传新附件，选择测试图片上传 3. 若上传成功且可正常预览，说明故障已解决；若仍失败，按照本文场景从上到下逐一排查即可，覆盖99%以上织梦图片上传故障场景。