Metaplex项目执行node index.js命令运行报错问题咨询

前置场景 #

当前已完成NFT生成前的图层资源整理、各图层对应NFT生成数量的配置工作，运行关联Metaplex config.js的生成命令node index.js时触发运行错误，按以下优先级逐一排查即可定位问题：

• 配置文件合法性校验
  首先单独执行node config.js确认配置文件本身无语法错误，重点核对三类配置项：
  • 图层文件夹路径、文件匹配规则和实际本地资源路径完全一致，注意macOS/Linux系统区分路径大小写，不要出现拼写偏差
  • 各图层配置的生成数量、稀有度权重加总后和设定的NFT总发行量匹配，所有数值类配置不要写成字符串格式，不要漏填必填字段
  • 配置文件内不要出现多余尾逗号、缺失闭合括号、中文全角标点这类低级语法错误
• 图层资源合规性校验
  • 所有图层文件必须为脚本支持的PNG格式，不要混入PSD、WEBP、后缀手动篡改的损坏图片，可批量打开图层文件确认无损坏
  • 同一系列所有图层的画布尺寸必须完全统一（例如统一为1000*1000px），尺寸偏差会直接触发画布合成阶段报错
  • 图层文件命名不要带空格、特殊字符，图层文件夹内不要混入系统生成的隐藏文件（例如macOS的.DS_Store、Windows的Thumbs.db）
• 运行环境与依赖校验
  • 核对本地Node.js版本，Metaplex相关生成脚本对v16.x稳定版兼容性最好，过高或过低的Node版本都会出现兼容报错，可执行node -v查看当前版本，不符合就切换版本后重试
  • 若之前装过依赖，先删除项目目录下的node_modules文件夹和package-lock.json文件，重新执行npm install全量重装依赖，解决依赖包损坏、版本不匹配的问题
  • 确认项目文件夹有正常读写权限，Windows端不要把项目放在系统盘受保护目录（如Program Files）下，macOS/Linux遇权限报错可直接给项目目录开放读写权限
• 基于报错栈精准定位

  对照报错截图里的错误栈信息，可直接锁定问题根源：

  • 报Cannot find module xxx：依赖未安装完整或模块引用路径错误，重装对应依赖即可
  • 报ENOENT: no such file or directory：配置中填写的文件/文件夹路径不存在，按报错提示的路径核对修正即可
  • 报Canvas/Image相关错误：基本为图层文件损坏、尺寸不统一、格式不支持导致，逐一排查图层资源即可
  • 报数值/范围类错误：回到config.js核对各图层权重、生成数量的配置逻辑，避免出现权重为负、总数量不匹配的问题

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