DedeCMS上传报错：常见问题分步排查与完整实操解决指南

一、前置排查：先确认报错类型

操作前先打开浏览器按F12调出开发者工具，切换到「控制台」查看上传请求返回的具体报错信息，对照下文对应场景解决，以下是DedeCMS最常见的4类上传报错，按顺序排查即可落地解决。

二、各类报错实操解决步骤

2.1 提示「文件大小超过限制」报错解决

该报错由PHP配置和DedeCMS后台配置双重限制导致，分两步修改：

• 第一步：修改PHP配置文件php.ini

  先找到服务器上php.ini的存放路径，常见路径：Linux一般为/etc/php/7.x/apache2/php.ini或/usr/local/php/etc/php.ini，Windows一般为PHP安装目录\php.ini，打开文件后找到三个参数，修改为你需要的大小，例如允许上传10M文件修改为：

  ```
  upload_max_filesize = 10M
  post_max_size = 10M
  memory_limit = 128M
  ```
  

  修改完成后必须重启Web服务器（Apache/Nginx/PHP-FPM），配置才会生效。

• 第二步：修改DedeCMS后台上传上限

  登录DedeCMS后台，依次点击：系统 → 系统基本参数 → 上传设置，找到「最大上传文件大小」选项，修改为对应数值（单位为KB，10M对应填写10240），保存配置即可。

2.2 提示「上传目录没有写入权限」报错解决

该报错由服务器目录权限配置错误导致，分环境操作：

• Linux服务器操作步骤

  

  登录服务器后进入DedeCMS根目录，执行以下命令给uploads目录设置可写权限，将命令中的「/网站绝对路径」替换为你自己的网站实际根目录：

  ```
  chmod -R 755 /网站绝对路径/uploads
  chown -R www:www /网站绝对路径/uploads
  ```
  

  如果修改后依然报错，可以临时设置为777权限测试，测试完成后建议改回755保证安全性：

  ```
  chmod -R 777 /网站绝对路径/uploads
  ```
  

  注意：必须同步给uploads目录下的allimg、media、soft三个子目录设置相同权限，80%的用户漏改子目录导致问题无法解决。

• Windows服务器操作步骤

  打开服务器文件管理器，找到DedeCMS根目录下的uploads文件夹，右键点击「属性」，取消勾选「只读」选项；切换到「安全」选项卡，给IIS默认用户（一般为开头的用户）添加「写入」权限，保存配置即可。

2.3 提示「你所上传的文件类型不允许」报错解决

该报错是DedeCMS默认禁用了部分扩展名上传，两种修改方式：

• 后台修改（推荐）

  登录DedeCMS后台，依次点击：系统 → 系统基本参数 → 附件设置，找到「允许上传的附件类型」选项，在原有内容后添加你需要的扩展名，多个扩展名用空格分隔，例如允许上传webp格式，就在末尾添加 webp，保存后清空缓存即可。

• 配置文件修改（后台无法登录时使用）

  打开DedeCMS根目录下的data/common.inc.php文件，找到配置项$cfg_upload_allow_type，直接修改值添加扩展名，示例如下，可直接复制修改后替换：

  ```
  $cfg_upload_allow_type = 'jpg jpeg gif png bmp webp zip rar doc pdf txt';
  ```
  

  保存后上传覆盖原文件即可生效。

2.4 点击上传无反应/上传后图片变空白报错解决

该问题90%是开启水印功能后水印文件丢失导致，解决步骤：

• 第一步：打开DedeCMS根目录，检查data/mark/目录下是否存在你设置的水印图片文件，如果文件不存在继续下一步。
• 第二步：登录DedeCMS后台，依次点击：系统 → 系统基本参数 → 图片水印设置，把「是否开启加水印」修改为「否」，保存即可解决；如果需要保留水印功能，将正确的水印图片上传到data/mark/目录，修改后台水印文件路径对应即可。

三、修改后验证步骤

所有修改完成后，执行两步验证确保问题解决：

• 1. 清空DedeCMS系统缓存：后台依次点击生成 → 更新缓存，勾选所有选项后点击确定更新。
• 2. 清除浏览器缓存，或打开浏览器无痕模式，重新上传一个符合要求的小文件测试，能正常上传就说明问题解决。

四、特殊情况处理

• 如果按以上步骤操作后依然报错，先检查DedeCMS版本，旧版本存在上传组件兼容bug，可直接下载官方最新版本，取出include/upload.class.php覆盖服务器上的同名文件即可，官方最新版本下载地址：https://www.dedecms.com/download.html
• 如果使用宝塔、云锁等安全防护面板，检查面板是否拦截了上传请求，暂时关闭防护测试，如果是拦截导致，将uploads目录添加到面板白名单即可。