Grails中<button type='submit'>无法指定表单动作的问题排查

问题核心 #

在Grails表单里用<g:actionSubmit>能正常触发不同控制器动作，但换成<button type="submit">（为了自定义UI样式）后，控制器接收的params映射里没有对应的_action_xxx参数，导致无法跳转到目标动作。对比之下，<input type="submit">能够正常传递参数，<button>却不行。

解决方案 #

方案1：给<button>明确设置name和value属性 #

Grails识别多动作表单的核心是提交按钮的name属性以_action_xxx格式命名，只要保证<button>的name符合规则，同时设置value属性（值可任意填写），就能让参数正常传递：

<form action="/handover/update/19" method="post">
  <!-- 原input类型提交按钮 -->
  <input type="submit" name="_action_submitForReview" value="Submit For Review" class="btn btn-primary">

  <!-- 修复后的button类型提交按钮 -->
  <button type="submit" name="_action_submitForReview" value="submitForReview" class="btn btn-primary">
    <span class="spinner-border spinner-border-sm" role="status" aria-hidden="true"></span>
    Submit For Review
  </button>

  <input type="submit" name="_action_update" value="Save" class="btn btn-secondary">
</form>

注意：这里的value不需要和动作名一致，Grails只会解析name属性中_action_后面的部分来匹配控制器动作。

方案2：用隐藏字段+JS手动指定动作 #

如果方案1无效，可通过隐藏字段存储目标动作，点击按钮时用JS设置字段值再提交表单，兼容性更强：

<form action="/handover/update/19" method="post">
  <!-- 新增隐藏字段存储目标动作 -->
  <input type="hidden" name="_action" id="targetAction">

  <!-- 改为type="button"，避免默认提交行为干扰 -->
  <button type="button" class="btn btn-primary submit-btn" data-action="submitForReview">
    <span class="spinner-border spinner-border-sm" role="status" aria-hidden="true"></span>
    Submit For Review
  </button>

  <button type="button" class="btn btn-secondary submit-btn" data-action="update">
    Save
  </button>
</form>

<script>
// 绑定按钮点击事件
document.querySelectorAll('.submit-btn').forEach(btn => {
  btn.addEventListener('click', function() {
    // 设置隐藏字段的动作值
    document.getElementById('targetAction').value = this.dataset.action;
    // 提交表单
    this.form.submit();
  });
});
</script>

此时控制器可通过params._action获取动作名，在update动作中添加分支处理：

def update() {
  switch(params._action) {
    case 'submitForReview':
      // 执行提交审核逻辑
      break
    case 'update':
      // 执行保存逻辑
      break
  }
}

方案3：直接用formaction指定目标路径 #

放弃Grails的_action_xxx机制，直接给<button>设置formaction属性，指定控制器动作的完整路径：

<form action="/handover/update/19" method="post">
  <button type="submit" formaction="/handover/submitForReview/19" class="btn btn-primary">
    <span class="spinner-border spinner-border-sm" role="status" aria-hidden="true"></span>
    Submit For Review
  </button>

  <button type="submit" formaction="/handover/update/19" class="btn btn-secondary">
    Save
  </button>
</form>

需要确保控制器中存在submitForReview动作，且路由配置正确。

问题原因 #

<input type="submit">提交时会自动将自身的name和value作为表单参数发送到服务器；而<button>标签如果内部包含HTML子元素（比如示例中的加载动画span），部分浏览器或Grails的参数解析逻辑无法正确捕获其name参数，即使设置了value也可能失效，导致Grails无法识别目标动作。

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