文档AEMAEM 教程AEM as a Cloud Service 教程

asset compute可扩展性故障诊断

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • 中级
  • 有经验的
  • 开发人员

以下是为AEM Assets开发和部署自定义Asset compute工作程序时可能遇到的常见问题和错误以及解决方案的索引。

开发 develop

返回的部分已绘制/损坏 rendition-returned-partially-drawn-or-corrupt

  • 错误：呈现版本未完全呈现（图像时），或者已损坏，无法打开。

    已返回部分绘制的演绎版

  • 原因：辅助进程的renditionCallback函数在完全写入rendition.path之前退出。

  • 解决方案：查看自定义工作进程代码并确保使用await同步执行所有异步调用。

开发工具 development-tool

asset compute项目中缺少Console.json文件 missing-console-json

  • 错误： ​错误：在async setupAssetCompute (.../node_modules/@adobe/asset-compute-devtool/src/assetComputeDevTool.js:XX:YY)验证(.../node_modules/@adobe/asset-compute-client/lib/integrationConfiguration.js:XX:YY)时缺少必需的文件

  • 原因： Asset compute项目的根目录中缺少console.json文件

  • 分辨率： ​从您的Adobe I/O项目下载新的console.json

    1. 在console.adobe.io中，打开将Asset compute项目配置为使用的Adobe I/O项目
    2. 点按右上方的​ 下载 ​按钮
    3. 使用文件名console.json将下载的文件保存到Asset compute项目的根目录下

manifest.yml中的YAML缩进不正确 incorrect-yaml-indentation

  • 错误： YAMLException：第X行、第Y列上的映射条目缩进错误：（通过从aio app run命令输出的标准）
  • 原因： Yaml文件具有空格敏感性，您的缩进可能不正确。
  • 分辨率： ​检查您的manifest.yml并确保所有缩进均正确。

memorySize限制设置过低 memorysize-limit-is-set-too-low

  • 错误： ​本地开发服务器OpenWhiskError：PUThttps://adobeioruntime.net/api/v1/namespaces/xxx-xxx-xxx/actions/xxx-0.0.1/__secured_workeroverwrite=true返回HTTP 400（错误请求） —>“请求内容格式错误：要求失败：内存比允许的阈值134217728 B低64 MB”
  • 原因： manifest.yml中辅助进程的memorySize限制设置为低于错误消息所报告的最小允许阈值（字节）。
  • 分辨率： ​查看manifest.yml中的memorySize限制并确保它们都大于允许的最小阈值。

由于缺少private.key，开发工具无法启动 missing-private-key

  • 错误： ​本地Dev ServerError：在validatePrivateKeyFile中缺少必需的文件… （通过aio app run命令中的标准输出）
  • 原因： .env文件中的ASSET_COMPUTE_PRIVATE_KEY_FILE_PATH值不指向private.key或private.key当前用户不可读。
  • 分辨率： ​查看.env文件中的ASSET_COMPUTE_PRIVATE_KEY_FILE_PATH值，并确保它包含文件系统上private.key的完整、绝对路径。

Source文件下拉列表不正确 source-files-dropdown-incorrect

asset compute开发工具可能会进入提取陈旧数据的状态，在​ Source文件 ​显示不正确项目的下拉列表中最为明显。

  • 错误： Source文件下拉列表显示不正确的项目。
  • 原因： ​过时的缓存浏览器状态导致
  • 解决办法： ​在浏览器中完全清除浏览器选项卡的“应用程序状态”、浏览器缓存、本地存储和Service Worker。

devToolToken查询参数缺失或无效 missing-or-invalid-devtooltoken-query-parameter

  • 错误： Asset compute开发工具中的“未授权”通知
  • 原因： devToolToken缺失或无效
  • 解决方法： ​关闭Asset compute开发工具浏览器窗口，终止通过aio app run命令启动的任何正在运行的开发工具进程，然后重新启动开发工具（使用aio app run）。

无法删除源文件 unable-to-remove-source-files

  • 错误： ​无法从开发工具UI中删除添加的源文件

  • 原因： ​此功能尚未实现

  • 分辨率： ​使用.env中定义的凭据登录到您的云存储提供商。 找到开发工具使用的容器（也在.env中指定），导航到​ 源 ​文件夹，并删除任何源图像。 如果已删除的源文件继续显示在下拉列表中，则您可能需要执行Source文件下拉列表中所述的步骤不正确，因为这些文件可能缓存在开发工具“应用程序状态”的本地。

    Microsoft Azure Blob Storage

测试 test

测试执行期间未生成演绎版 test-no-rendition-generated

  • 错误： ​失败：未生成演绎版。

  • 原因： ​辅助进程由于意外错误(如JavaScript语法错误)未能生成演绎版。

  • 解决方案： ​在/build/test-results/test-worker/test.log查看测试执行的test.log。 找到此文件中与测试失败案例对应的部分，并检查错误。

    疑难解答 — 未生成演绎版

测试生成错误的演绎版，导致测试失败 tests-generates-incorrect-rendition

  • 错误： ​失败：演绎版“rendition.xxx”与预期不同。

  • 原因： ​辅助进程输出的格式副本与测试用例中提供的rendition.<extension>不同。

    • 如果预期的rendition.<extension>文件不是以与测试用例中本地生成的演绎版完全相同的方式创建的，则测试可能会失败，因为比特数可能有一些差异。 例如，如果Asset compute工作进程使用API更改对比度，并通过调整Adobe Photoshop CC中的对比度创建预期结果，则文件可能显示相同，但位中的细微变化可能不同。

  • 分辨率： ​通过导航到/build/test-worker/<worker-name>/<test-run-timestamp>/<test-case>/rendition.<extension>查看测试中的演绎版输出，并将其与测试用例中的预期演绎版文件进行比较。 要创建完全预期的资产，请执行以下操作：

    • 使用开发工具生成演绎版，验证其是否正确，并将其用作预期的演绎版文件
    • 或者，在/build/test-worker/<worker-name>/<test-run-timestamp>/<test-case>/rendition.<extension>处验证测试生成的文件，验证它是否正确，并将其用作预期的演绎版文件

调试

调试器未附加 debugger-does-not-attach

  • 错误：处理启动项时出错：错误：无法连接到位于……的调试目标
  • 原因： Docker桌面未在本地系统上运行。 通过查看VS代码调试控制台（“查看”>“调试控制台”）来验证此设置，确认报告了此错误。
  • 分辨率：启动Docker Desktop并确认已安装必需的Docker映像。

断点未暂停 breakpoints-no-pausing

  • 错误：从可调试的开发工具运行Asset compute工作进程时，VS代码不会在断点处暂停。

未附加VS代码调试器 vs-code-debugger-not-attached

  • 原因： VS代码调试器已停止/断开连接。
  • 分辨率： ​重新启动VS代码调试器，并通过观看VS代码调试输出控制台（“视图”>“调试控制台”）来验证其是否附加

辅助进程执行开始后附加的VS代码调试器 vs-code-debugger-attached-after-worker-execution-began

  • 原因： VS代码调试器在点按“开发工具”中的​ 运行 ​之前未附加。
  • 解决方法： ​通过查看VS代码的Debug Console（“视图”>“调试控制台”），确保已附加Asset compute程序，然后从开发工具中重新运行调试程序。

Worker在调试时超时 worker-times-out-while-debugging

  • 错误：调试控制台报告“操作将在 — XXX毫秒内超时”或Asset compute开发工具的演绎版预览无限期旋转，或
  • 原因：调试期间超出了manifest.yml中定义的辅助进程超时。
  • 解决办法：在manifest.yml中临时增加辅助进程的超时或加快调试活动。

无法终止调试器进程 cannot-terminate-debugger-process

  • 错误：命令行上的Ctrl-C未终止调试器进程(npx adobe-asset-compute devtool)。

  • 原因： @adobe/aio-cli-plugin-asset-compute 1.3.x中存在错误，导致Ctrl-C未被识别为终止命令。

  • 分辨率：将@adobe/aio-cli-plugin-asset-compute更新到版本1.4.1+

    code language-none 
    $ aio update

    故障排除 — aio更新

部署 deploy

AEM中的资源缺少自定义演绎版 custom-rendition-missing-from-asset

  • 错误： ​已成功新建和重新处理资源进程，但缺少自定义呈现版本

处理配置文件未应用于上级文件夹

  • 原因： ​该资产不存在于具有使用自定义工作线程的处理配置文件的文件夹下
  • 分辨率： ​将处理配置文件应用到资源的上级文件夹

处理配置文件被较低的处理配置文件取代

  • 原因： ​资产存在于应用了自定义工作进程处理配置文件的文件夹下，但已在该文件夹和资产之间应用了不使用客户工作进程的其他处理配置文件。
  • 分辨率： ​合并或以其他方式协调两个处理配置文件并删除中间处理配置文件

AEM中的资源处理失败 asset-processing-fails

recommendation-more-help
4859a77c-7971-4ac9-8f5c-4260823c6f69