退出 Creative Cloud 桌面应用程序。
上次更新日期：
2026年8月14日
查找故障排除信息以解决在使用 Adobe Asset Link 时可能遇到的各种问题。
关于 Adobe Asset Link 面板
Adobe Asset Link 作为扩展安装在您的 Creative Cloud 应用程序中：Photoshop、Illustrator 和 InDesign。安装和配置完成后，在 Illustrator 和 InDesign 中从窗口 > 扩展 > Adobe Asset Link打开面板，在 Photoshop 中从窗口 > 扩展（旧版） > Adobe Asset Link打开面板。使用该面板访问、使用和编辑存储在 Adobe Experience Manager Assets 中的数字资产，以及上传新资产。了解使用 Adobe Asset Link 管理资源。
注释
如果您在浏览时无法看到资源缩略图但可以查看资源预览，请要求您的管理员使用最新的服务包更新 Adobe Experience Manager Managed Services (AMS)。
如果您无法访问 Adobe Asset Link 面板，请联系您的管理员获取故障排除指导。
开始故障排除之前
如果您无法使用 Adobe Asset Link 面板，请在排查特定错误之前完成以下检查：
- 在安装或重新安装 Adobe Asset Link 之前关闭您的 Creative Cloud 应用程序，以刷新应用程序缓存。
- 检查 Adobe Asset Link 是否安装在com.adobe.assetlink文件夹中，位置为：macOS /Library/Application Support/Adobe/CEP/extensions；Windows C:\\Program Files (x86)\\Common Files\\Adobe\\CEP\\extensions。如果遇到问题，请删除com.adobe.assetlink文件夹来移除现有版本，然后安装最新版本。
- 验证assetlink-settings.json文件是否存在于：macOS /Users/<username>/Library/Application Support/Adobe/CEP/extensions；Windows C:\\Users\\<username>\\AppData\\Roaming\\Adobe\\CEP\\extensions。
- 确保您在 Creative Cloud 桌面应用程序中使用 Enterprise ID 或 Federated ID 登录。
- 确保在 Creative Cloud 桌面应用程序中启用文件同步。
- 使用活动监视器 (macOS) 或任务管理器 (Windows)，确保名为CoreSync的进程正在运行。
如果您是管理员，还需要确保：
- 所有 IMS 配置均正确完成。
- 在 Adobe Admin Console 中，用户的商业、企业或 Federated ID 已添加到在 Experience Manager 服务器中配置的用户组。
- 在 Experience Manager 服务器中配置的 IMS 用户组是 Experience Manager 中dam-users组的一部分。
如果您将 Adobe Asset Link 与部署了使用 S3 作为数据存储库的 Experience Manager 6.5.5 或更高版本一起使用，请检查平台 API 是否正常工作。访问 https://<server>:<port>/platform/content/dam 来检查连接问题。如果平台 API 正常工作，响应将是顶级 DAM 对象的 JSON 表示。故障会返回 500 错误，Adobe Asset Link 将无法连接。要解决此问题，请将 S3 数据存储库连接器升级到版本 1.10.12 或更高版本。
要让 Adobe Asset Link 与 Apple M1 设备上的 Illustrator 和 InDesign 兼容，请将 Adobe Asset Link 升级到最新版本。Adobe Asset Link 在 Rosetta 模拟模式下支持 M1 设备上的 Photoshop。要了解如何在 Apple silicon 上运行 Photoshop，请参阅Photoshop for Apple silicon。
错误情景
以下是您在使用 Adobe Asset Link 面板时可能遇到的错误以及解决步骤。
错误
在使用 Adobe Extension Manager 命令行工具 (ExManCmd) 安装扩展时出现 Abort trap: 6 错误。
原因
在 macOS 上安装 Adobe Asset Link 失败。 在 Windows 上安装失败，并且不显示任何错误。
要解决该问题，请执行以下操作。
从以下位置删除 ExMan.db：
macOS：/Library/Application Support/Adobe/Extension Manager CC/Configuration/DB。
Windows：C:\ProgramData\Adobe\Extension Manager CC\Configuration\DB。
重新启动 Creative Cloud 桌面应用程序，并使用在步骤 1 中使用的相同凭据登录。
重新安装包含 Adobe Asset Link 扩展的包。 此时会安装 Adobe Asset Link 面板。
错误
原因
如果尝试用 Adobe ID 登录并访问 Adobe Asset Link，则出现此错误。 如果您没有 Creative Cloud 企业版帐户，请与您的 IT 管理员联系。
错误
|
如果您无权访问此服务，请与您的 IT 管理员联系以获准访问。 |
原因
如果您没有访问 Experience Manager 服务器所需的权限，则出现此错误。
要解决此错误，如果 Experience Manager 服务器正常运行，请与您的 IT 管理员联系。
错误
|
无法访问您尝试访问的 Experience Manager Assets 服务器。 请与您的 Adobe Experience Manager 管理员联系以获取进一步的详细信息。 |
原因
如果在连接到 Experience Manager 服务器时网络连接中断或 Experience Manager 服务器不可用，则出现此错误。
要解决此错误，请确保您已连接到 Internet 并执行以下操作：
检查 Experience Manager 服务器是否已启动并正在运行。
退出并重新启动您正在使用的 Creative Cloud 应用程序。
启动 Adobe Asset Link 面板。
错误
|
您的 Creative Cloud 企业版帐户可能无权访问此 Experience Manager Assets 服务器。 请与您的 Adobe Experience Manager 管理员联系以获得帮助。 |
原因
如果您的 Creative Cloud 企业版帐户无权访问 Experience Manager Assets 服务器，则出现此错误。
如果您的本地 assetlink-settings.json 文件内的一个或多个设置不正确，则还可能会发生授权错误（有关详细信息，请参阅文档）。 请与您的 Experience Manager 管理员联系以获得帮助。 具体而言，在以下情况下会发生此错误：
- 未授权用户访问 Experience Manager 服务器。
- 用户帐户未添加到在 Experience Manager 中配置的 IMS 组。
- 添加到用户帐户的 IMS 组与 Experience Manager IMS 组不匹配。
- assetlink-settings.json 文件包含错误的 aemPort。
- assetlink-settings.json 文件中缺少 aemServer 的值。
注释
具有代理环境的客户被禁止使用 Adobe Asset Link。 Adobe Asset Link 尚不支持代理环境。
如果未授权用户访问 Experience Manager、其帐户未添加到 Experience Manager 或与其中的 IMS 组不匹配，请执行以下操作：
在 Admin Console 的用户页面上，搜索用户帐户。
从用户列表中，单击相关用户的名称。
在“用户组”下，确认关联的 IMS 组是否与 Experience Manager 匹配。
可在“aem-instance/system/console/configMgr”>“Adobe Granite OAuth IMS Provider”>“组映射”下检查 Experience Manager 组映射。
注释
对于 Experience Manager 6.4 和更高版本，如果未定义组映射，请确保 IMS 用户组是 Experience Manager 中 dam-users 组的一部分。
如果用户未与 Experience Manager 中的 IMS 组关联，请编辑用户组并分配为 Experience Manager 配置的用户组。
请参阅配置 assetlink-settings.json 文件并添加到所有设备，以确保 assetlink-settings.json文件中的 aemPort 和 aemServer 的值正确。 如果仍然出现错误，请与您的 IT 管理员联系以验证以下各项：
- 您有正确的权限可访问 Experience Manager 服务器。
- 您被添加到在 Experience Manager 中配置的 IMS 组。
作为新用户，如果您在启动 Adobe Asset Link 时看到“添加新环境”视图（而非“主页”视图），请执行以下操作之一：
- 更新到 Adobe Asset Link 的最新版本。
- 确保 CEP > 扩展 文件夹位于计算机上的以下位置，具体取决于操作系统。 如果该文件夹尚不存在，请创建它。
- Windows：C:\Users\<用户名>\AppData\Roaming\Adobe\CEP\extensions
- macOS：/Users/<用户名>/Library/Application Support/Adobe/CEP/extensions
- Windows：C:\Users\<用户名>\AppData\Roaming\Adobe\CEP\extensions
错误
|
您尝试访问的 Experience Manager Assets 服务器无响应。 请与您的 Adobe Experience Manager 管理员联系以获取进一步的详细信息。 |
原因
当您无法连接到 Experience Manager 服务器时，出现此错误。
要解决此错误，请与您的 IT 管理员联系以检查 Experience Manager 服务器是否已启动并正在运行。
错误
|
无 Internet 连接。 |
原因
当您未连接到 Internet 时，出现此错误。
要解决此错误，请确保计算机已连接到 Internet。
在 InDesign 2020 或更高版本内使用 Adobe Asset Link 上下文菜单中的“放置链接资源”选项时，可能会遇到以下错误。 直接在 Experience Manager 服务器中确认 InDesign Client ID InDesignAem2 被添加到已批准的列表。
有关如何将客户端 ID 添加到批准列表的信息，请参见使用配置程序包配置 Experience Manager。
注释
如果您拥有 Experience Manager Assets as a Cloud Service 实例，则无需此项。 它仅适用于 AMS 和本地 Experience Manager Assets 实例。
对 Experience Manager 上的链接资源所做的更改有时对 InDesign 中的用户不可见，除非他们删除本地 InDesign 缓存。 该问题可能是由于对链接资源的元数据的权限不足。
要解决此问题，请确保用户在 CRxDe 的 /content/dam/dam:batch 节点中具有“修改”访问权限。
如果 Experience Manager Assets 和 Adobe Asset Link 中的资源搜索返回不同的结果，请尝试执行视觉相似性搜索以获得一致的结果。
启用客户端日志
启用客户端日志有助于调试连接问题，因为您需要客户端和服务器日志才能诊断连接错误。
在 Creative Cloud 应用程序（Photoshop、InDesign 和 Illustrator）中为 Adobe Asset Link 扩展启用 DEBUG 或 TRACE 级别的客户端日志记录很容易。 只需创建一个单行文本文件 assetlink-override.json 即可。
该文件仅包含 DEBUG 级别日志记录的以下代码行：
{"LOG_LEVEL":"DEBUG"}
要启用 TRACE 级别日志记录，请将值更改为 trace，如下所示：
{"LOG_LEVEL":"TRACE"}
将该文件放在 assetlink-settings.json 文件所在的相同位置。
- macOS：/Users/<用户名>/Library/Application Support/Adobe/CEP/extensions
- Windows：C:\Users\<用户名>\AppData\Roaming\Adobe\CEP\extensions
在本例中，用户名 是您计算机上的登录 ID。
重新启动 Creative Cloud 应用程序（Photoshop、Illustrator 或 InDesign）。 重新打开 Adobe Asset Link 时，它将按照适当的日志记录级别在临时目录中创建日志文件。
临时目录位于以下位置，具体取决于操作系统：
- macOS：/tmp
- Windows：%TEMP%（通常解析为 C:\Users\username\AppData\Local\Temp）
日志文件的名称是 adobe-assetlink-APPN-99.9.9.log。
APPN 是 PHXS、IDSN 或 ILST 这些名称之一。 数字 99 是 Creative Cloud 应用程序的版本号。 以下是 Photoshop 的示例文件名。
adobe-assetlink-PHXS-19.1.2.log
该日志文件只有几 KB 大小。
客户端日志有助于调试连接问题，因为诊断连接错误需要客户端和服务器日志。
要在 Adobe XD 中为 Adobe Asset Link 启用 DEBUG 或 TRACE 级别的客户端日志记录，请创建一个单行文本文件 assetlink-override.json。
该文件仅包含 DEBUG 级别日志记录的以下代码行：
{"LOG_LEVEL":"DEBUG"}
要启用 TRACE 级别日志记录，请将值更改为 trace，如下所示：
{"LOG_LEVEL":"TRACE"}
将该文件与您的 storage.json 文件放在相同位置。
- macOS：~/Library/Application/Support/Adobe/UXP/PluginsStorage/SPRK/External/61d229b9/PluginData
- Windows：C:\Users\<用户名>\AppData\Roaming\Adobe\UXP\PluginsStorage\SPRK\External\61d229b9\PluginData
在本例中，用户名 是您计算机上的登录 ID。
重新启动 Adobe XD。 当 Adobe Asset Link 重新打开时，它在以下位置创建一个具有适当的日志记录级别的日志文件：
- macOS：~/Library/Application/Support/Adobe/UXP/PluginsStorage/SPRK/External/61d229b9/PluginData/logs
- Windows：C:\Users\<用户>\AppData\Roaming\Adobe\UXP\PluginsStorage\SPRK\External\61d229b9\PluginData\logs
该日志文件的名称为 adobe-assetlink-XD-4X.X.XX.XX.xxx.log。
该日志文件只有几 KB 大小。
注释
X 的值因所使用的 Adobe XD 版本而异。 但是，您必须使用 Adobe XD 41.0 或更高版本。
使用 assetlink-settings.json 手动配置端点
对于新用户，可在创建用户帐户之前预配计算机。 根据操作系统的不同，将 assetlink-settings.json 文件复制到以下位置之一：
- macOS：/Library/Application Support/Adobe/CEP/extensions
- Windows：\Program Files (x86)\Common Files\Adobe\CEP\extensions
新用户启动 Adobe Asset Link 时，后者在系统位置扫描设置文件。 然后，根据操作系统的不同，它将该文件复制到以下用户区域之一：
- macOS：../Library/Application Support/Adobe/CEP/extensions
- Windows: ..\AppData\Adobe\CEP\extensions (Windows)
确保用户对 assetlink-settings.json 文件所在的文件夹具有读取权限。 另请确保部署计算机上的未来用户具有对该文件夹的读取访问权限。
注释
如果设备上没有文件夹路径，请手动创建 CEP > extensions 文件夹。
下载示例 assetlink-settings.json 文件，并在文本编辑器中打开它。
修改该文件以包括一个或多个 Experience Manager Assets 端点。
{"aemServer":"SERVERNAME","aemPort":"SERVERPORT","aemScheme":"PROTOCOL"}
|
参数 |
描述 |
|---|---|
|
SERVERNAME |
Experience Manager 服务器的名称或 URL |
|
SERVERPORT |
Experience Manager 服务器的端口号 |
|
PROTOCOL |
Experience Manager 服务器 URL 的协议方案。 使用 HTTP 或 HTTPS。 |
例如，如果 Experience Manager 服务器 URL 为：http://content.demo.com:4502，则该 .json 文件应包括以下代码：
- {"aemServer":"content.demo.com","aemPort":"4502","aemScheme":"http"}
.json 文件的更多示例如下：
- {"aemServer":"author.customer.com","aemPort":"443","aemScheme":"https"}
- {"aemServer":"localhost","aemPort":"4502","aemScheme":"http"}
- {"aemServer":"author-nossl.customer.com","aemPort":"80","aemScheme":"http"}
使用 json 文件在 Adobe Asset Link for XD 中添加 Experience Manager 环境
要在 Adobe Asset Link for XD 中添加 Experience Manager 环境，请使用特定环境的 URL 更新 assetlink-settings.json 文件。
将 assetlink-settings.json 文件配置为指向新的 Experience Manager 实例。 启动 Adobe XD，然后从以下位置打开 storage.json 文件：
- macOS：Users/<用户名>/Library/Application/Support/Adobe/UXP/PluginsStorage/SPRK/External/61d229b9/PluginData
- Windows：C:\Users\<用户名>\AppData\Roaming\Adobe\UXP\PluginsStorage\SPRK\External\61d229b9\PluginData
该文件包含条目
{"aemEnvironments": [{ "root": url, "title": title }],
"activeAemEnvironmentRoot": url,
"viewMode": "grid}
将“url”替换为您的 Experience Manager Assets 实例的 URL。 将 URL 括在引号中。 保存并关闭该文件。 退出并重新启动 Adobe XD 以使其连接到 Experience Manager Assets。
注释
如果 assetlink-settings.json 文件不同，Adobe Asset Link for XD 将重定向到发现服务工作流程。
