Statamic CMS中Bard编辑器空格自动修剪问题解析

在Statamic CMS项目中，开发者遇到一个关于Bard富文本编辑器的特殊问题：当用户对段落中的文字添加粗体或斜体格式时，保存后格式标记前后的空格会被自动删除。该问题虽然看似简单，但涉及到底层中间件逻辑和配置参数的相互作用。

问题现象

项目升级到Statamic v5.38.0后出现特定行为：

1. 在Bard编辑器中为文字添加格式标记（如粗体或斜体）
2. 保存内容后，格式标记前后的空格消失
3. 通过开发者工具检查发现，请求payload中实际包含空格字符
4. 问题仅出现在特定项目环境，测试环境无法复现

技术根源

经过排查发现这与两个关键机制相关：

1. 字符串修剪中间件
   系统默认会启用Laravel的TrimStrings中间件，该中间件会自动去除请求数据中的前后空格

2. 控制面板路由检测
   Statamic通过特殊逻辑判断当前请求是否属于控制面板(CP)路由：

   • 正常情况会跳过CP路由的字符串修剪
   • 但当CP_ROUTE设为空字符串时（常见于headless无头模式），检测逻辑失效

解决方案

对于采用headless架构的项目，建议通过以下方式解决：

1. 配置修正方案
   在AppServiceProvider中强制禁用字符串修剪：

   public function boot()
   {
       \Illuminate\Foundation\Http\Middleware\TrimStrings::skipWhen(function () {
           return true; // 全局跳过修剪
       });
   }
   

2. 架构建议
   对于headless项目，更规范的实践是：

   • 明确区分API路由和CP路由
   • 即使不使用前端层，也应设置明确的CP路由前缀
   • 考虑使用专门的API中间件组

深度解析

该问题反映出Statamic在headless模式支持上的一个边界情况。当CP_ROUTE为空时，系统实际上运行在"全CP路由"模式下，此时应当默认跳过所有修剪操作。这属于框架在特殊配置下的预期行为缺失，建议在后续版本中优化路由检测逻辑。

对于开发者而言，理解Laravel中间件的工作机制和Statamic的路由识别逻辑，有助于快速定位类似的数据处理异常问题。在headless架构中，明确的路由划分和中间件配置是保证数据完整性的关键。