本文旨在解决在使用 WP All Import 插件导入文章时，由于文章标题包含特殊字符（如西里尔字母）或URL过长，导致 URL 被截断，从而引发“Duplicate records detected during import”错误的问题。我们将介绍如何通过设置“Post Slug”选项并进行适当的标题转换来确保导入文章具有正确的 URL。
在使用 WP All Import 导入文章时，正确设置 URL 至关重要，尤其是在使用非拉丁字母或 URL 长度超过 WordPress 限制的情况下。 默认情况下，WordPress 会根据文章标题生成 URL（即“Post Slug”）。 如果标题包含特殊字符（例如西里尔字母）或过长，WP All Import 可能会截断 URL，从而导致重复记录错误和导入失败。 以下是解决此问题的步骤：
1. 了解问题根源
当 WordPress 的固定链接设置为 %postname% 时，它会尝试根据文章标题生成 URL。如果文章标题包含特殊字符或过长，WP All Import 可能会截断生成的 URL，导致多个文章具有相同的 URL。这将违反数据库唯一性约束，并导致 "Duplicate records detected during import" 错误。
2. 利用 "Post Slug" 选项
WP All Import 提供了一个 "Post Slug" 选项，允许您手动设置文章的 URL。 这为您提供了对 URL 生成过程的更多控制权。
- 在 WP All Import 的导入设置中，找到 "Other Post Options" 部分。
- 您将看到一个名为 "Post Slug" 的字段。
3. 处理特殊字符和 URL 长度
如果您的文章标题包含特殊字符（例如西里尔字母），您需要将它们转换为拉丁字母或其他 URL 安全的字符。 这称为音译或转录。
- 音译/转录： 将包含西里尔字母或其他特殊字符的文章标题转换为拉丁字母。 例如，可以将 "Привет мир" 转换为 "Privet mir"。
- 手动输入： 您可以手动输入每个文章的 "Post Slug"，确保它是唯一的且 URL 安全的。
- 自动生成： 编写自定义函数，自动将文章标题转换为 URL 安全的 "Post Slug"。 以下是一个 PHP 示例，使用 sanitize_title() 函数：
4. WP All Import 设置示例
假设您有一个 CSV 文件，其中包含 "title" 和 "content" 列。 您可以使用以下步骤在 WP All Import 中设置 "Post Slug"：
- 在 WP All Import 中，选择您的 CSV 文件。
- 将 "title" 列映射到 WordPress 的 "Title" 字段。
- 在 "Other Post Options" 部分，将 "Post Slug" 字段映射到 CSV 文件中包含音译后标题的列（如果已预先处理）。 如果您没有预先处理，您可以创建一个自定义函数，在导入过程中动态生成 "Post Slug"。 例如，您可以创建一个 PHP 函数，该函数接收 "title" 作为输入，并返回音译后的 "Post Slug"。 然后在 WP All Import 中使用该函数。
5. 避免常见错误
- 确保 "Post Slug" 的唯一性： 每个文章的 "Post Slug" 必须是唯一的。 如果多个文章具有相同的 "Post Slug"，WordPress 将无法区分它们。
- 使用 URL 安全字符： "Post Slug" 只能包含小写字母、数字和连字符 (-)。 避免使用空格、特殊字符和其他非 URL 安全的字符。
- 限制 URL 长度： 虽然 WordPress 允许较长的 URL，但建议将 "Post Slug" 保持在合理的长度内（通常小于 200 个字符）。
总结
通过利用 WP All Import 的 "Post Slug" 选项并正确处理特殊字符和 URL 长度，您可以确保导入的文章具有正确的 URL，避免重复记录错误，并成功完成导入过程。 根据您的具体需求，您可以选择手动输入 "Post Slug"、使用音译/转录，或编写自定义函数来自动生成 "Post Slug"。 关键是确保每个文章的 "Post Slug" 是唯一的且 URL 安全的。
