JHipster蓝图模板解析异常：文件存在却提示找不到

问题背景 #

使用jhipster generate-blueprint生成蓝图模板后，在generators/server/templates目录下新增了helm/Chart.lock文件，但运行npm run update-snapshots时触发报错，提示模板文件找不到——该文件实际存在于路径~/Development/devhipster/generators/server/templates/helm/Chart.lock。这可能和蓝图开发中npm run update-snapshots的使用时机有关。

报错信息 #

...
1) SubGenerator server of devhipster JHipster blueprint
       run
         "before all" hook for "should succeed":
     Error: Template file helm/Chart.lock was not found at ~/Development/devhipster/generators/server/templates,~/Development/devhipster/node_modules/generator-jhipster/generators/server/templates
      at renderTemplate (node_modules/generator-jhipster/generators/generator-base.js:2521:17)
      at ~/Development/devhipster/node_modules/generator-jhipster/generators/generator-base.js:2681:69
      at Array.map (<anonymous>)
      at default.writeFiles (node_modules/generator-jhipster/generators/generator-base.js:2681:53)
      at default.writingTemplateTask (file://~/Development/devhipster/generators/server/generator.mjs:21:20)
      at Object.<anonymous> (node_modules/generator-jhipster/node_modules/yeoman-generator/lib/index.js:1091:23)
      at ~/Development/devhipster/node_modules/run-async/index.js:49:25
      at new Promise (<anonymous>)
      at ~/Development/devhipster/node_modules/run-async/index.js:26:19
      at ~/Development/devhipster/node_modules/generator-jhipster/node_modules/yeoman-generator/lib/index.js:1092:9
      at new Promise (<anonymous>)
      at default.executeTask (node_modules/generator-jhipster/node_modules/yeoman-generator/lib/index.js:1063:12)
      at runLoop.add.once (node_modules/generator-jhipster/node_modules/yeoman-generator/lib/index.js:1043:14)
      at Immediate.<anonymous> (node_modules/grouped-queue/lib/subqueue.js:48:34)
      at processImmediate (node:internal/timers:466:21)

相关代码 #

服务器生成器generator.mjs关键代码 #

...
  get [WRITING_PRIORITY]() {
    return {
      async writingTemplateTask() {
        await this.writeFiles({
          sections: {
            files: [{
              templates: ['helm/Chart.lock'],
            }],
          },
          context: this,
        });
      },
    };
  }
  ...

代码变更Diff #

diff --git a/generators/server/generator.mjs b/generators/server/generator.mjs
index f15e19f2..88b0518e 100644
--- a/generators/server/generator.mjs
+++ b/generators/server/generator.mjs
@@ -20,7 +20,9 @@ export default class extends ServerGenerator {
       async writingTemplateTask() {
         await this.writeFiles({
           sections: {
-            files: [{ templates: ['template-file-server'] }],
+            files: [{
+              templates: ['helm/Chart.lock'],
+            }],
           },
           context: this,
         });

补充说明 #

当前JHipster蓝图开发工作流文档中，关于快照在提交变更、流水线部署等环节的使用说明存在空白，导致排查这类问题时缺乏参考依据。

内容的提问来源于stack exchange，提问作者javafueled