基于MySQL的Sails.js项目500内部服务器错误解决方案

报错本质是代码中引用的Product模型实例未被正确初始化挂载，导致调用find/create等ORM方法时找不到对应函数，最终触发500服务端内部错误。

• 修正Controller的模型引用逻辑
  若项目关闭了全局模型挂载开关，直接在Controller代码中编写Product会拿到未定义的空值，自然无法调用ORM方法。推荐在Controller顶部显式导入模型，避免全局注入带来的兼容问题：

  // api/controllers/ProductController.js 头部添加导入语句
  const Product = require('../models/Product');
  

• 校验模型文件的结构与命名
  • 模型文件必须存放于api/models/目录下，文件名和代码中引用的模型名完全匹配大小写（正确命名为Product.js，不能随意修改为小写或其他大小写组合）
  • 模型的导出结构必须符合Sails加载规范，attributes定义必须包裹在module.exports导出对象内部。如果结构错误，Sails加载模型时会拿到空对象，不会自动挂载ORM内置方法。正确的完整模型文件结构参考：

    // api/models/Product.js
    module.exports = {
      attributes: {
        name: {
          type: 'string'
        },
        qty: {
          type: 'integer'
        }
      }
    };
    

• 检查MySQL数据存储配置
  模型挂载依赖对应数据库适配器的正常初始化，如果适配器未安装或者连接配置错误，模型会初始化失败，变为没有ORM方法的空对象：
  • 确认项目已安装MySQL适配器依赖，执行安装命令：npm install sails-mysql --save
  • 打开config/datastores.js配置文件，确认默认连接的adapter字段指向已安装的MySQL适配器，数据库地址、账号、密码、库名配置准确，无连接权限问题。
• 重启Sails开发服务
  修改模型定义、数据存储配置、全局开关后，Sails的热重载机制偶尔会出现模型加载失败的情况，直接终止当前运行的服务，重新执行启动命令拉起服务即可。

补充说明：当前find接口的catch逻辑编写的res.NotFound(err)不符合接口设计逻辑，Product查找操作无匹配数据时会返回空数组，不会抛出资源不存在的错误。等核心500问题修复后，建议将catch逻辑替换为统一的服务端错误返回逻辑，避免误触发404状态码。

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