排查产品目录错误和警告

选择了错误的格式

你选择的格式（例如 TXT）与上传的文件（例如 XML）不匹配。

重新上传并选择与文件匹配的格式。XML 文件使用 .xml 扩展名，CSV 文件使用 .csv，而 TAB 分隔文件使用 .txt.

文件名不匹配

你上传的文件名必须与 上传文件名 在目录设置中设定的名称完全一致，包括扩展名。

重命名你的文件，或更新 上传文件名 ，使两者完全匹配。

压缩文件无法处理

impact.com 支持 gzip 和标准 zip 压缩文件。压缩文件可使用第二个扩展名表示压缩，例如 catalog.xml.gz.

请确认你的压缩类型是 gzip 或 zip，并且文件的格式和压缩都使用了正确的扩展名。

无法连接到服务器

请确认你正在连接到主机 products.impact.com ，端口为 21.

请在 FTP 客户端中更新正确的主机和端口，然后重新连接。

缺少 FTP 凭据

你需要使用为你的账户颁发的 FTP 登录名和密码才能连接。

找到你的 FTP 产品数据系统凭据 ，位于你的账户技术配置设置中。如果你找不到或无法访问它们， 联系支持团队.

你的 feed 平台无法连接

请确认你的平台正在连接到主机 products.impact.com ，端口为 22，并且使用的是为你的账户颁发的凭据。

请在标准 SFTP 客户端（如 FileZilla 或 Cyberduck）中测试相同的凭据。如果客户端可以连接，但你的 feed 平台仍然不行，请将目录切换为 从 URL 拉取 并使用以下步骤。

URL 不是直接下载链接

在浏览器中打开你的 URL。如果它重定向到登录页、云存储落地页，或者返回 404 或 403 错误，则该 URL 不是直接下载链接。

将 URL 更新为可直接下载文件，或在浏览器中打开时以原始数据形式显示的链接。

文件名不匹配

该 上传文件名 在你的目录设置中设定的文件名必须与该 URL 处的实际文件名完全匹配，包括扩展名（.csv, .xml, .txt, .gz).

更新 上传文件名 ，使其与文件名完全匹配。哪怕很小的不匹配也会导致 未找到与请求匹配的目录 错误。

格式或分隔符不匹配

请确认所选格式（CSV、TXT、XML、GMC）与你的文件匹配。如果你使用的是分隔文件，请确认分隔符（逗号、制表符、竖线）与配置一致。

在目录设置中更正格式或分隔符。不匹配会导致 未找到有效记录 错误。

FTP/SFTP：凭据或路径无效

请确认你的 URL 使用以下格式 sftp://{username}:{password}@{host}/{file_path}。路径必须指向具体文件，而不只是目录。凭据中的特殊字符必须进行 URL 编码（例如， @ 变为 %40).

使用 FileZilla 等 FTP 客户端测试你的凭据。用更正后的凭据和完整文件路径更新 URL。

拉取超时或连接失败

你的服务器防火墙可能正在阻止 impact.com 的请求。

请联系你的主机提供商或 IT 团队，将 impact.com 的 IP 地址范围列入允许名单。

URL 需要身份验证

此上传方式不支持基于会话或基于 cookie 的身份验证。

请使用可公开访问的直接下载 URL，或在 URL 中嵌入 HTTP Basic Auth（https://user:pass@host/path），或者使用在 URL 中包含凭据的 FTP/SFTP。如果你的 feed 需要基于浏览器的登录，请将目录切换为其他上传方式，例如 直接上传 或 impact.com FTP 服务器.

URL 超过 2,048 个字符

带签名的云存储 URL 可能会超过 2,048 个字符限制，并可能被截断。

请使用能保留直接下载的 URL 缩短服务，或将文件托管在更短的 URL 上。

目录卡在处理中或待处理状态

请检查该文件是否仍可通过该 URL 访问，以及文件大小对于你的抓取频率来说是否异常过大。

请确认文件可用。如果目录仍停留在 处理中 或 待处理, 联系支持团队 ，请请求手动重新处理。

目录停止自动更新

请检查文件是否仍可在相同 URL 访问，以及文件名、格式或服务器访问设置是否已更改。

请在原始 URL 恢复文件，或更新目录设置以反映新的 URL 或文件名。对于大型目录（1,000,000+ 项），请考虑降低抓取频率以避免超时。

上传后字段或数据缺失

请确认你的字段名称与所选格式的规范一致，例如 Google Merchant Center 字段 适用于 GMC 格式。将标准规范之外的自定义字段映射到 impact.com 的自定义字段槽位（数值1, 文本1等等）。

从 impact.com 下载你已上传的目录，并将其与源文件进行比较，以找出数据丢失的位置。根据需要更新字段名称或映射，然后重新上传。

记录“X”：缺少必填字段：(字段名称)

指定的行缺少一个或多个必填字段。

记录“X”：CatalogItemId(CatalogItemId)：缺少必填字段：(字段名称)

数据文件中的一行缺少必填字段。

未找到请求对应的目录。请检查上传文件的文件名是否与为该目录注册的名称相同

该 上传文件名 在 上传方式 部分中设置的名称与您上传的文件名不完全匹配。

目录文件中没有属性

产品目录数据文件中没有可处理的数据。

目录中 ID 相同的目录项出现多次，首个之后的记录将被忽略

两个或多个项目具有相同的 ID。所有产品都需要唯一值，重复项不会被处理。

记录“X”存在错误：（第 X 行）在封装标记与分隔符之间存在无效字符

某一行对双引号的使用无效。请用双引号将该字段括起来，并将其他所有双引号替换为两个双引号。

（起始行 X）在封装标记完成前已到达 EOF

EOF 表示“文件结尾”。所述起始行存在未闭合的开头双引号，或意外的换行中断了数据流。

解析（目录类型）字段时出错：值为（字段）

产品字段无效，无法接受。

记录（recordNumber）出错：分隔值的数量（FieldsLength）与预期数量（ColumnNamesLength）不匹配

对于某一行，数据存在于没有标题的列中。

在目录文件中未找到有效记录。请根据你配置的目录格式检查文件内容，然后重新上传。

impact.com 已读取该文件，但其中不包含任何产品记录。请检查文件是否包含你的产品并与所选目录格式匹配，然后重新上传。

文件中超过 10% 的记录有错误，因此目录未更新。请检查并更正这些记录，然后重新上传文件。

有错误的记录过多，目录无法更新。这包括每条记录都有错误的文件。请参阅 了解 10% 错误阈值 如下所示。

目录文件不是有效的 XML，无法读取。请确保该文件是格式正确的 XML，然后重新上传。

XML 文件为空、被截断或存在未闭合的标签，因此 impact.com 无法读取。请修复 XML 使其格式正确，然后重新上传。

该文件似乎不是有效的 RSS 或 Atom feed 格式。请检查文件是否与你配置的目录格式一致，然后重新上传。

该文件不是 RSS 或 Atom feed，例如当错误网页被保存为你的 feed 代替文件时。XML 目录文件必须包含 rss, RDF，或 feed 作为其起始元素。

我们无法读取你的目录文件内容……

impact.com 无法读取文件内容。常见原因包括文件为空、文件结构异常、分隔符无效或字符编码不正确。请检查文件是否与所选目录格式匹配，然后重新上传。如果问题仍然存在， 联系支持团队.

我们无法从配置的拉取 URL 获取目录文件。请验证该 URL 以及文件是否可访问。

impact.com 无法从 拉取 URL 你目录设置中的 从 URL 拉取 以上内容排查该 URL。

由于内部系统错误，处理失败……

你无需采取任何操作。上一次成功处理的目录仍会继续对合作伙伴可用。请参阅 impact.com 状态页面 以了解服务中断的详细信息。

值为（字段值）的字段（字段名称）没有有效的协议

该字段值不是格式正确的 URL。

分隔符问题：错误的逗号、制表符或空行会破坏字段之间的边界。

请更正目录文件中的分隔符用法，确保每个字段都一致分隔，然后重新上传。

描述字段中的换行会中断记录处理。

分隔文本格式（CSV 和 TSV）不支持换行。上传前请移除描述等文本字段中的换行。