Discord.js开发deliver命令时触发Cannot read property 'id' of null TypeError

报错「TypeError: Cannot read property 'id' of null」的触发逻辑是代码尝试读取值为null的对象的id属性，结合提供的代码片段，按触发概率从高到低定位问题点位：

核心报错触发点 #

• 角色获取逻辑无空值兜底
  代码开篇执行逻辑：
  let employeeRole = message.guild.roles.cache.get("745410836901789749");
  当机器人所在服务器不存在ID为745410836901789749的角色、或机器人无权限读取该角色时，.cache.get()方法会直接返回null。后续代码紧跟着执行权限判断：
  if(message.member.roles.cache.has(employeeRole.id))
  此时直接读取null值的id属性，会100%抛出对应报错。
• 其他同类型空值风险点
  • var me = message.guild.members.cache.get(client.user.id);：当机器人自身成员信息未完成缓存时，该返回值也可能为null，虽当前代码未调用该变量，但存在潜在报错隐患
  • 订单分发逻辑中client.guilds.cache.get(order.guildID)：如果对应订单的服务器已经将机器人移出，该调用返回null时，后续链式读取.me、.name属性会触发同类型报错
  • 订单状态判断逻辑中client.users.get(order.chef)：当订单对应的厨师用户未完成客户端缓存时，该调用返回null，后续读取.username属性会触发同类型报错

修复方案 #

1. 给角色获取逻辑增加非空校验，避免空值读取

   let employeeRole = message.guild.roles.cache.get("745410836901789749");
   // 角色不存在时直接终止流程返回提示
   if (!employeeRole) {
       return message.reply("服务器配置异常，未找到配送员工角色，请联系管理员检查配置");
   }
   

2. 所有调用.cache.get()的点位，统一做非空判断，禁止直接对返回值做链式深层属性读取
3. 补充排查：代码内部直接使用了未声明的prefix变量，实际运行时也会触发未定义报错，需要确认命令调度入口是否将prefix参数传入execute方法。
4. 版本适配修正：代码中client.guilds.get()、client.users.get()的写法是discord.js v11版本的语法，当前主流的v12及以上版本需要通过client.guilds.cache.get()、client.users.cache.get()获取实例，否则也会触发读取undefined属性的报错。

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