Mongoose自定义statics.login调用时WebStorm提示未解析的解决方法

该提示是WebStorm静态代码检查的告警，不是代码运行错误，现有代码在运行时可以正常调用login方法。
触发告警的核心逻辑：mongoose.model()默认返回通用的Mongoose Model类型，WebStorm做静态分析时仅能识别Mongoose Model内置的原生方法，无法自动感知通过userSchema.statics动态挂载的自定义login方法，因此判定方法未定义给出提示。

• JSDoc标注引入侧类型（推荐，无运行时侵入）
  在路由文件引入User模型的位置添加类型注释，显式告知编辑器自定义方法的存在，添加后告警立即消失：

/**
 * @typedef {import('mongoose').Model & {
 *  login: (email: string, password: string) => Promise<import('mongoose').Document>
 * }} UserModel
 */
/** @type {UserModel} */
const User = require("../models/userModel");

• JSDoc标注模型导出侧类型
  在userModel.js导出User的位置统一添加类型声明，后续所有引入该模型的文件都能自动识别自定义静态方法，无需重复标注：

// 原有静态方法定义、模型创建逻辑保持不变
const User = mongoose.model('user', userSchema);

/** @type {import('mongoose').Model & {login: (email: string, password: string) => Promise<ReturnType<typeof User.findOne>>}} */
module.exports = User;

• 忽略单行检查规则
  若不需要对该行做严格的方法存在性校验，可将光标定位到报错的login位置，按Alt+Enter调出快速修复菜单，选择「Suppress for the statement」即可屏蔽该行告警，不影响其他位置的检查规则。
• TypeScript项目显式声明模型接口
  若项目使用TypeScript，可定义继承Mongoose Model的用户模型接口，显式声明login静态方法的入参、返回值类型，从类型定义层面彻底解决识别问题。

内容的提问来源于stack exchange，提问作者Tsentseus Askold TI-11