Google Sheets通过Google Script实现附件上传功能失效排查求助

直接导致功能完全失效的核心逻辑错误 #

• 菜单绑定写错函数：onOpen里给自定义菜单项绑了doGet，这是Web应用部署时的专用入口函数，根本没法在表格客户端的菜单点击场景下运行，点了直接报错，连上传弹窗都弹不出来。改法很简单：把弹窗那几行代码挪到一个普通自定义函数里（比如叫showUploadDialog），菜单项绑这个普通函数就行，别碰doGet。
• 超链接公式写错分隔符：upload函数里拼的HYPERLINK公式用了分号;当参数分隔符，Google Sheets公式只认半角逗号,，就算文件真传到Drive了，单元格里的公式也是报错状态，根本点不开。改的时候把公式里的分号全换成逗号就行，格式对齐=HYPERLINK("文件链接","文件名")。
• 冗余代码干扰：upload里重复定义了两次activeSheet变量，虽然不直接报错，但白占位置，删掉重复的那行就行，减少排查干扰。

点提交没反应的前端绑定问题 #

• 传参方式有问题：现在前端是把整个form DOM对象扔给后端脚本，跨上下文传的时候很容易序列化失败，后端接收到的参数是空的，直接报读不到upload属性的错。改法是单独把文件输入框里的File对象取出来传给后端，别整个DOM都往上扔。
• 没加错误捕获：现在前端的上传链路只写了成功后的回调，失败了啥提示都没有，用户点了按钮就像没反应似的，根本不知道哪错了。要补个失败回调，把后端报的错直接弹出来，一跑就知道问题出在哪。

一步步验证排查 #

• 先测弹窗触发：刷新表格，点顶部的「Attach」菜单，看能不能正常弹出上传框，弹不出来就回头查菜单绑的函数对不对，别绑Web专用的入口函数。
• 再测文件传递：弹窗出来后选个几M的小测试文件，点提交看弹不弹错误提示，如果提示文件参数为空，就回去改前端的传参逻辑。
• 最后测链接生成：确认文件真的传到指定Drive文件夹后，看选中的单元格里是不是生成了能点的跳转链接，如果公式报错，就回去查公式里的分隔符是不是换对了。
• 权限兜底：第一次跑脚本的时候，要去脚本编辑器里手动给Sheets、Drive的访问授权，没授权的话脚本会被浏览器直接拦下来，根本跑不起来。还要确认当前登录账号对配置的目标Drive文件夹有编辑权限，不然上传的时候会触发API权限报错。

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