如何从客户端HTML向服务器传递表单及额外参数？

你遇到的问题根源在于Google Apps Script的google.script.run对表单对象的处理是特殊的：它只能单独传递表单DOM对象（此时会自动将其序列化为表单数据对象），无法直接将表单对象与其他参数组合传递，也不能把表单对象放进数组里传递——因为这些场景下，表单对象无法被正确解析成服务器能识别的表单数据。

下面逐个分析你尝试的方式的问题，以及对应的正确解决思路：

错误方式的问题 #

1. 双参数方式：当你把this.form作为第一个参数，第二个参数是var1时，google.script.run会优先处理表单对象，但后续参数的序列化会出现冲突，导致服务器端无法正确接收第二个参数。
2. 数组包裹方式：数组中的表单对象不会被google.script.run自动解析为表单数据，服务器端收到的数组里只会是无法处理的DOM对象引用，而非实际的表单字段值。
3. 单独声明数组：HTML模板里的<? ?>是服务器端脚本，运行时还没有客户端DOM，this.form此时是undefined；即使你在客户端声明数组，同样会遇到数组里的表单无法被解析的问题。

正确解决方案 #

方案1：将额外变量作为表单隐藏字段传递（最简单） #

直接在表单内添加隐藏输入框，把额外变量的值存进去，这样传递this.form时就会自动包含该变量：

<form>
  <!-- 你的其他表单字段 -->
  <input type="hidden" name="extraVar" id="extraVar">
  <button onclick="google.script.run.processForm(this.form)">Submit</button>
</form>

<script>
  // 提前给隐藏字段赋值
  document.getElementById('extraVar').value = var1;
</script>

服务器端函数：

function processForm(formData) {
  // 直接从formData中获取额外变量
  const extraVar = formData.extraVar;
  // 处理表单其他字段...
}

方案2：客户端先将表单转为普通对象，再与额外变量组合传递 #

手动收集表单数据为普通对象，再和额外变量一起拼成一个新对象传递：

<button onclick="submitForm()">Submit</button>

<script>
  function submitForm() {
    // 获取表单元素
    const form = document.querySelector('form');
    // 将表单转为普通对象
    const formObj = Object.fromEntries(new FormData(form));
    // 组合额外变量
    const data = {
      formData: formObj,
      var1: var1 // 你的额外变量
    };
    // 发送到服务器
    google.script.run.processForm(data);
  }
</script>

服务器端函数：

function processForm(data) {
  const formData = data.formData;
  const var1 = data.var1;
  // 处理逻辑...
}

方案3：多参数传递（需先序列化表单） #

如果一定要用多参数，先把表单序列化为JSON字符串，再传递字符串和额外变量：

<button onclick="submitForm()">Submit</button>

<script>
  function submitForm() {
    const form = document.querySelector('form');
    const formObj = Object.fromEntries(new FormData(form));
    const formJson = JSON.stringify(formObj);
    google.script.run.processForm(formJson, var1);
  }
</script>

服务器端函数：

function processForm(formJson, var1) {
  const formData = JSON.parse(formJson);
  // 处理逻辑...
}

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