[Bug]: Dataset settings Save silently fails on API-created General datasets with null table_column_* fields

快速结论：这个问题通常出现在“通过 HTTP API 创建的空 General 数据集（naive 分块）”上：返回的 parser_config 里 table_column_mode、table_column_roles、table_column_names 为 null，进入 Dataset > Configuration 后点击 Save 不会发出数据集更新请求，浏览器控制台只打印 “Validation errors”。优先排查前端表单校验是否被这三个 null 字段卡住。

适用环境：RAGFlow 官方 Docker 镜像 infiniflow/ragflow:v0.27.2；Self-hosted Docker Compose；Linux x86_64；后端 Python；文档引擎 Elasticsearch；浏览器 Chromium 151.0.7922.108。复现使用空数据集，无需文档或模型推理，未修改前端。

最快修复方案：暂无确认的一步修复方案。Issue 中验证过的绕行方式是用官方 API 先规范化三个字段：PUT /api/v1/datasets/<dataset_id>，请求体为 {"parser_config": {"table_column_mode": "auto", "table_column_roles": {}, "table_column_names": []}}，之后重新加载 Configuration 页面再保存。

注意事项：该 PUT 绕行方案只在报告者的隔离空数据集上验证过；对已有文档或自定义 parser_config 的数据集是否安全，Issue 未给出验证。评论摘要还提到，新版本主分支已改变校验逻辑，null 的 table_column_* 字段无法再阻塞保存，但该结论来自源码审查和运行时校验复现，并非完整的真实 UI 往返测试。如果你不在 v0.27.2，先确认版本再决定是否采用绕行方案。

问题场景

用户在 RAGFlow Web UI 的 Dataset > Configuration（/dataset/configuration/<dataset_id>）中点击 Save，或把 Permissions 从 Only me 改成 Team 后保存，页面没有任何更新请求发出；刷新后设置未生效。触发条件是：该 General 数据集通过 POST /api/v1/datasets 创建，chunk_method 为 naive，并显式传入 parser_config（例如只传 chunk_token_num）。返回的 parser_config 中三个 table 专用字段为 null。

报错原文

Validation errors
[table_column_mode]
[table_column_roles]
[table_column_names]
{
  "table_column_mode": null,
  "table_column_roles": null,
  "table_column_names": null
}

原因分析

按 Issue 正文的描述，前端 schema 对这三个 table 专用字段使用 optional 校验器，但 optional() 不接受 null；而 API 返回的 parser_config 恰好给这三个未使用的字段填了 null，于是表单校验失败。Save 处理逻辑调用 form.trigger()，校验失败时只把 “Validation errors” 打到浏览器控制台，不提交更新，页面上也没有可见的错误提示，因此表现为“静默保存失败”。报告者验证：仅规范化这三个字段并重新加载后，Save 能发出 PUT 请求并返回 code 0。需注意，评论摘要中的后续验证认为主分支已不再校验这些字段，因此上述原因针对 v0.27.2 等旧版本路径。

环境排查

确认 RAGFlow 镜像版本：报告环境为 infiniflow/ragflow:v0.27.2；不同版本的 dataset settings 表单校验逻辑可能不同。
确认部署方式与后端：Self-hosted Docker Compose、Python 后端、Elasticsearch 文档引擎。
确认数据集来源：是否通过 POST /api/v1/datasets 创建，且 chunk_method 为 naive、显式传入 parser_config。
检查该数据集的 parser_config 是否包含 table_column_mode、table_column_roles、table_column_names 且值为 null。
打开浏览器 DevTools 的 Network 与 Console：观察点击 Save 后是否有 PUT 请求发出、Console 是否出现 “Validation errors”。
浏览器环境为 Chromium 151.0.7922.108；确认未对前端做自定义修改。

解决步骤

先用 GET /api/v1/datasets/<dataset_id>（或等价接口）读取该数据集的 parser_config，确认三个 table_column_* 字段是否为 null。
可优先尝试的绕行：调用 PUT /api/v1/datasets/<dataset_id>，请求体使用 Issue 中验证过的规范化值：{"parser_config": {"table_column_mode": "auto", "table_column_roles": {}, "table_column_names": []}}。请求时只改动这三个字段，避免覆盖其他 parser_config 配置。
重新打开 /dataset/configuration/<dataset_id>，修改 Permissions 或任意设置后点击 Save。
如仍失败，保持 DevTools 打开，检查 Console 中的完整校验错误，并记录是哪个字段触发校验失败。
如果数据集已有文档或重要 parser_config，执行第 2 步前先备份当前 parser_config，因为 Issue 未验证该 PUT 对非空数据集的完整影响。

验证方法

点击 Save 后，在 DevTools > Network 中应能看到发往数据集更新接口（PUT）的请求并返回成功（报告者环境返回 code 0），Console 不再出现 “Validation errors”；刷新 Configuration 页面后，修改的 Permissions 或设置应保持生效。