Sails.js@^1.0.0版本Helper使用失败求助：API开发替代Service遇阻

我明白你升级到Sails 1.0后，从熟悉的Service切换到官方推荐的Helper时遇到了卡点——毕竟新的Helper、Action写法和之前的Service差异不小，咱们一步步拆解问题，把你的示例代码补全并跑通。

第一步：正确定义Helper #

首先，Helper必须放在api/helpers/目录下，文件名要和你调用的testy完全对应（比如命名为testy.js）。完整的Helper结构需要包含输入参数、执行逻辑和输出处理，补全你的示例代码如下：

// api/helpers/testy.js
module.exports = {
  friendlyName: 'Testy',
  description: 'Test something.',
  // 定义输入参数：你调用时传了'sayHello'，这里对应定义一个必填字符串参数
  inputs: {
    message: {
      type: 'string',
      required: true,
      description: 'The message to process'
    }
  },
  // 可选：定义输出的异常状态（默认自带success和error，可按需扩展）
  exits: {
    invalidInput: {
      description: 'Invalid or missing input parameters'
    }
  },
  // 核心执行函数：接收输入参数和状态出口
  fn: async function (inputs, exits) {
    // 这里写你的业务逻辑，比如处理传入的消息
    let processedResult = `Helper processed your message: ${inputs.message}`;
    
    // 通过success出口返回结果
    return exits.success(processedResult);
  }
};

第二步：控制器中正确调用Helper #

注意：因为用了await，你的控制器Action必须标记为async函数，否则会报错。补全后的控制器调用代码如下：

// 示例控制器：api/controllers/TestController.js
module.exports = {
  callHelper: async function (req, res) {
    try {
      // 方式1：直接传单个参数（对应Helper中第一个必填的input）
      var ob = await sails.helpers.testy('sayHello');
      // 方式2：用对象传参（多参数时更清晰，推荐）
      // var ob = await sails.helpers.testy({ message: 'sayHello' });
      
      return res.json({ ob: ob });
    } catch (err) {
      // 捕获参数错误、Helper内部异常等问题
      return res.status(500).json({ error: err.message });
    }
  }
};

常见踩坑点排查 #

• 文件位置错误：Helper必须放在api/helpers/下，文件名要和调用名称完全一致（比如testy.js对应sails.helpers.testy）
• 异步标记遗漏：控制器Action必须加async关键字，才能使用await调用Helper
• 参数不匹配：如果Helper定义了必填input，调用时必须传值，否则会抛出参数缺失错误
• 忘记返回结果：Helper的fn函数必须通过exits.success()返回数据，否则调用会一直处于等待状态

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