前言：DedeCms保存`dede_addonarticle`附加表数据出错的常见现象

DedeCms作为国内广泛使用的开源内容管理系统，在网站建设和内容管理方面拥有较高的灵活性和 性。但在实际应用过程中， 许多用户反映，在后台发布文章或编辑文章时经常遇到“把数据保存到数据库附加表 dede_addonarticle 时出错”的问题，错误信息通常为：

Duplicate entry 'xxx' for key 'PRIMARY'

这类错误不仅影响正常发布流程，还可能导致数据丢失或页面异常。本文将该问题产生的根本原因，并结合最新版本DedeCms提供权威、具体且可操作的解决方案。

一、问题解析：为什么会出现“Duplicate entry”主键重复错误？

理解问题本质，是解决技术难题的第一步。该报错提示“Duplicate entry 'xxx' for key 'PRIMARY'”意为尝试插入数据库时 主键字段出现了重复值，导致插入失败。

1.1 主键冲突的背景

DedeCms中， dede_addonarticle 表是用来存储文章 字段数据的附加表，和主表 dede_archives 通过主键ID进行关联。正常情况下每篇文章在两个表中的ID应保持一致且唯一。

主键冲突主要来自以下几种情况：

• ID生成机制异常：新插入的数据使用了已存在的ID。
程序逻辑错误导致重复调用插入语句。< li=""> 程序逻辑错误导致重复调用插入语句。<>

1.2 DedeCms系统设计上的特殊性

DedeCms设计中并非所有附加表都自动支持自增长主键。dede_addonarticle 的主键往往是继承自关联文章编号， 如果某些操作导致这个编号被提前占用或者重新使用，就会引发主键冲突。

二、 典型案例分析及复现环境说明

2.1 案例描述

用户A反馈，在DedeCms后台点击“发布文章”时系统报错：

Error: Duplicate entry '2532' for key 'PRIMARY'

一边无法成功保存文章内容，需要反复删除草稿才能继续操作。

2.2 复现步骤

2.3 错误日志及截图示例

 Duplicate entry '2532' for key 'PRIMARY'
File: /dede/include/archives.class.php
Line: 1024
SQL: INSERT INTO dede_addonarticle VALUES 

三、官方推荐解决方案详解与实操步骤指导

3.1 核心思路：避免主键重复与合理设计索引约束关系

DedeCms官方针对该问题提供两种核心思路：

• A方案： 去除dede_addonarticle 表中的PRIMARY KEY约束以允许多条记录存在相同ID。
• B方案： 将dede_addonarticle中的id字段设置成自增长，确保每条新增记录自动生成唯一标识。

步骤A：取消 `dede_addonarticle` 表中 PRIMARY KEY 约束

*注意*: 此方法适合临时绕过问题， 但可能对数据完整性有一定影响，请谨慎使用并做好备份！

1. 登录织梦后台管理系统 → 系统 → 系统设置 → SQL命令行工具 。
2. 施行以下SQL语句取消唯一约束：

ALTER TABLE dede_addonarticle DROP PRIMARY KEY;

3. 确认无误后尝试重新发布文章，看是否还存在冲突错误。
4. *如果出现英文乱码等异常，可手动编辑对应内容进行修正。*
5. *备注*: 取消主键后 虽然能够避免重复插入报错，但如果业务逻辑依赖唯一性，则需考虑额外的数据校验措施。
6. *备份提示*: 建议先备份当前数据库结构与数据，以防止误操作引起更大风险！
7. *官方建议*: 如条件允许， 更优雅的做法是采用下一节方案B优化结构，实现规范化设计。

步骤B：设置 `id` 字段为 自增长 自增列

DedeCms默认架构里 并非所有附加表都配置了自增属性，这可能是重复插入失败的重要原因。所以呢，将dede_addonarticle.id 字段调整为 AUTO_INCREMENT 类型能有效规避此类冲突：

1. 进入织梦后台 → 系统 → 系统设置 → SQL命令行工具 。确保已有完整备份！
2. 施行查询检查当前字段属性：

   SHOW COLUMNS FROM dede_addonarticle LIKE 'id';  
   -- 或  
   DESCRIBE dede_addonarticle;

   根据后来啊判断是否已配置AUTO_INCREMENT。 若无，则继续下一步修改。
3. 根据MySQL版本不同，可运行如下命令：

   ALTER TABLE dede_addonarticle MODIFY COLUMN id INT NOT NULL AUTO_INCREMENT;

   此处务必保证 id 字段为NOT NULL。 若需要，可以先删除原有PRIMARY KEY，再重新创建正确索引。 如需删除旧索引：

   ALTER TABLE dede_addonarticle DROP PRIMARY KEY;

   再添加新的主键：

   ALTER TABLE dede_addonarticle ADD PRIMARY KEY ;

   这样就实现了自动递增且唯一约束。
4. 完成以上步骤后 测试后台发布文章功能，看是否消除重复插入错误。 若依旧异常，可检查外部程序接口及其他插件干扰。 。
5. 升级补丁参考:建议关注 DdeCMS 官方论坛和 Github 最新补丁信息，部分版本已逐渐完善此机制。 更新日志示范： - 修复 `dede_addonarticle` 表 ID 重复插入的问题； - 优化后台写库逻辑，增强事务一致性； 以上都会极大提升稳定性和兼容性。

   ---

   四、辅助诊断技巧与最佳实践建议

   4.1 排查步骤清单 ：快速定位根因规则指南  🔍  🔍 🔍 

   • 检查MySQL版本及字符集是否兼容DdeCMS要求；
   • 确认 `dede_archives` 和 `dede_addonarticle` 两张关键业务表中 ID 是否同步且连续；
     示例查询代码: