Payload CMS v3.28.0 版本发布：性能优化与编辑器升级

项目简介

Payload CMS 是一个现代化的无头内容管理系统，采用 TypeScript 开发，为开发者提供了高度可定制的内容管理解决方案。它结合了直观的管理界面和强大的 API，支持多种数据库后端，特别适合需要灵活内容架构的项目。

编译性能大幅提升

本次 v3.28.0 版本引入了一个重要的性能优化选项，可以将开发环境下的编译时间减少约 50%。这项改进通过避免在开发过程中打包服务器专用依赖来实现。

要启用这一优化，开发者只需在 next.config.js 文件中进行简单配置：

const nextConfig = {
  // 原有配置
}

export default withPayload(nextConfig, { devBundleServerPackages: false })

需要注意的是，在极少数情况下，如果项目依赖开发环境中打包的服务器专用 Payload 依赖项，可能会遇到意外行为。因此，对于现有项目，这一功能需要手动启用。

Lexical 富文本编辑器升级

v3.28.0 版本将 Lexical 富文本编辑器的依赖从 0.21.0 升级到了 0.27.1。这一升级带来了多项改进：

1. 表格功能得到增强，修复了多个已知问题
2. 为未来添加颜色选择器等高频需求功能奠定了基础
3. 引入了更稳定的 HTML 转换器

对于手动安装了 Lexical 的项目，建议同步升级到 0.27.1 版本。Payload 团队推荐使用其重新导出的版本，而非直接安装 Lexical，以避免版本兼容性问题。

如果升级后遇到富文本编辑器相关问题，可以按照以下步骤解决：

1. 删除 node_modules 目录
2. 删除锁文件（如 pnpm-lock.json）
3. 重新安装依赖

核心功能增强

元数据处理改进

新版本对元数据处理进行了多项优化：

• 默认设置为 noindex nofollow，提升SEO管理的便捷性
• 完全暴露 Next.js 的元数据功能，提供更灵活的配置选项

字段验证增强

现在可以将路径信息传递给字段验证函数，使开发者能够基于字段位置实现更精确的验证逻辑。

JWT 认证扩展

增加了对 JWT 提取方法的细粒度控制，允许开发者指定支持哪些提取方法及其优先级顺序。

数据库优化

MongoDB 适配器现在会从读取结果中剔除模式中不存在的键，确保数据一致性并减少不必要的数据传输。

用户界面改进

表单状态管理

引入了表单状态队列机制，改善了复杂表单场景下的用户体验和性能表现。

本地化功能增强

• 增加了禁用特定集合的本地化复制功能选项
• 当默认区域设置不可用时，会优雅地回退到备用区域设置

文件上传优化

解决了图片尺寸处理中的压缩问题，确保原始文件上传时不会被强制压缩。

安全增强

加强了对锁定文档集合的访问控制，确保只有经过认证的用户才能访问这些敏感数据。

开发者体验优化

导入映射生成

改进了导入映射生成机制，现在支持 turbopack 和 tsconfig 的 basePath 配置，提供更可靠的开发体验。

类型安全

PostgreSQL 数据库适配器现在启用了 TypeScript 严格模式，提供更强的类型安全保障。

总结

Payload CMS v3.28.0 版本在性能、安全性和用户体验方面都带来了显著提升。特别是编译时间的优化和富文本编辑器的升级，将直接影响开发者的日常工作效率。新引入的各项配置选项和功能增强，为构建更复杂、更安全的内容管理系统提供了更多可能性。

对于现有项目升级，建议仔细测试新版本中的变更，特别是涉及富文本编辑器和认证流程的部分，确保平稳过渡。新项目则可以充分利用这些改进，从一开始就获得更好的开发体验。