4. 飞书连接

飞书问题先分为连接凭据、应用与文档权限、选中的数据表、字段与商品记录四层。读取列成功只证明已取得字段信息，还要检查本批货号与全部 SKU 的实际数据。

1.1 重读字段

进入对应平台“自动上新 → 配置”，检查当前多维表与数据表，再点击“读取飞书字段”。不需要点击“立即发布”来测试连接。

截图使用匿名列名，凭据不展示。真实配置应选择自己的字段，不要求把飞书列改成截图中的名称。

1.2 凭据错误

App ID 与 App Secret 必须来自同一个飞书应用。检查复制时是否带入空格、换行，应用密钥是否已被重置，以及当前切到的是哪张表的连接配置。

密钥重置后需要在店智效中更新对应配置，再读取字段。不要把完整 App Secret 发进聊天、截图或反馈附件；凭据格式核对由自己在飞书应用后台完成。

1.3 访问权限

需要核对的层次	原因	处理
应用身份的读取权限	应用没有多维表读取能力	在开放平台检查权限与发布生效状态
目标文档的访问授权	应用有能力，但这张表没有授权它访问	把同一个应用添加到目标多维表
高级权限范围	部分数据表、列或记录不允许应用读取	检查本次需要的表、字段和 SKU 记录范围

自己的飞书账号能在网页看到表，不表示应用也能读取。具体授权步骤见2. 飞书连接。只读取商品资料时，不为排错随意开放无关写入权限。

1.4 选项异常

确认复制的是 /base/ 类型的多维表格地址，并包含实际商品数据表的 table=；当前店智效不能直接读取 /wiki/ 地址。普通云文档、电子表格和另一张数据表不能代替。切表之后重新看表名、读取字段和映射。

新增、改名或删除列后，重新读取并检查标题、货号、类目、SKU、售价和库存的对应关系。列名相似不能代替字段含义：商品货号不是 SKU 编码，类目也不是店铺分类。

1.5 货号与 SKU

检查货号是否与本批范围完全一致，是否带多余空格，每个规格组合是否有一行完整记录，售价与库存是否为正确数值，以及应用是否能读取全部匹配行。

飞书视图筛选不决定本批发布范围。店智效按发布页的货号读取匹配 SKU，不能靠隐藏视图里的其他行来代替任务范围确认。缺货号、缺 SKU 或查询失败时，应修正具体问题，不扩大到整表读取掩盖错误。

1.6 恢复检查

重新读取字段后，能选择正确的列；再按该平台教程检查一个准备发布的货号，确认资料与图片都对应。处理结果未知的旧商品时，先核对旧任务与平台商品，再安排新任务。

反馈保留错误码、时间、受影响货号、选中的表名和已检查步骤；表格链接只通过必要的正式渠道提供，截图隐藏应用密钥与无关数据。