生命不息
折腾不止

本地跑得好好的,一上架就折腾:记一次 WorkBuddy 连接器上架

我自己的博客是 WordPress 搭的,十几年了,写文章、改状态、审评论,全在后台点。用上 WorkBuddy 之后我就琢磨,能不能把这个站直接接进来,让它替我发草稿、查评论、顺手看看哪篇文章的固定链接写歪了。平台上正好有连接器这个东西,做完传上去,别人也能装。

我以为一个晚上能收工。事实证明我又一次高估了自己。

一、包传上去,然后开始等

打包那一步是顺的。工具一个个写,本地跑一遍,握手正常,工具列表一个不少。我甚至拿它当成品用了一晚上,发了一篇草稿,改了一次状态,评论也翻了一遍。

传上去,等。回来一句:待补充授权配置。

我补了。再传。照旧这五个字。我又补了一次,第三次回来,依旧这五个字。平台上没有多余的说明,不告诉我是哪一项不对,也不给出处,就这五个字,翻来覆去。

那几天我盯着这行字,着实有些打扰我好好用电脑了。

后来才想明白,这五个字不是审核意见,是个前置门槛。它的意思接近:我这边起不来,没法往下评。也就是说,它说的和我以为的,压根不是一件事。

二、我自己猜了三轮,全错

被那句模糊的话卡住之后,我开始乱猜。猜了三个方向,一个都没中。

先是怀疑授权方式选错了。那一页除了问是否需要用户授权,还让人选一种走浏览器跳转的授权。我一开始真选了跳转那种,点发起授权,直接失败。后来想明白,我这种让用户自己填凭证的模式,本来就不该走浏览器跳转那条路。

接着怀疑权限。我是团队成员身份,不是开团队的那个人,就疑心是不是非得主账号才能提交。这个念头很快被自己否掉了,提交记录明明白白是我这个号提交的,东西也确实在团队名下。

然后是最像的一次:是不是我的程序根本没被打进包里。这个怀疑不是没道理,因为平台给的那条报错,翻译成人话就是连接被关掉了。连接被关掉,最直接的解释就是对面没起来。

三个方向都错,时间全花在补材料上。补一轮,退一轮,人就开始烦。

三、看记录,我先看错了账本

底下还压着一层麻烦。平台要企业资质,个人号提交不了,我只好托朋友把我拉进他的团队,连接器挂在团队名下。

坏就坏在这儿。我拿自己的账号去查,消息记录里都是空的,一条记录都没有。折腾了一阵才明白,我这个身份看到的只是我自己那一摊,团队名下的东西不在里头。我立马登陆了朋友的超管账号,记录立刻浮出来,错误是“前置审核通过,但在质量评测中的授权验证未通过。失败原因:连接器窗口报错:MCP error -32000: Connection closed,请检查提交的内容后再提交”。

距离真相近了一步,前面几个小时算是白等了。教训很朴素:查不到东西的时候,先想想自己是不是站错了地方。

四、真正的分界线

我把包解开,丢到一个空目录里,按包里写的方式启动。

起来了。工具也在。

那一刻我才看清问题在哪。程序本身没毛病,毛病在我用什么方式让它起来。我之前那条路子,是让平台去外面把程序取回来再跑。这个做法本身不新鲜,很多连接器就这么干,但它多了一个前提:外面的东西得先存在,当时那个地址还得通。

而我这边一直没把东西发出去。取不到,就起不来;起不来,就是连接被关掉。我本地跑得再顺,也证明不了它那边能跑。

更早的版本还有一个更隐蔽的:我在启动配置里写了个相对位置,本意是告诉它就在这个目录里找程序。结果对面并不是在那个目录里执行的,找不着文件,一样是连接被关掉。两个坑长得一模一样,提示也一模一样,原因差了十万八千里。

五、改法只有一句话

想通之后,改动小得出奇。方向就一句:别让它去外面取,也别让它猜自己在哪儿。

程序直接塞进包里,跟着包走,不依赖任何外部仓库先发布;启动方式只写跑包里这个文件,不写任何位置信息;运行环境交给平台自己准备,用户不需要装任何东西。顺带把一切需要联网下载的前置动作都清掉了。

就是把不确定性一条一条掐死。凡是留到以后再看的东西,都是将来的一个坑。

六、空目录里再跑一遍

改完我没有直接传,先做了一件事:把包解开,扔进一个空目录,什么依赖都不放,按包里的方式启动,然后握手、列工具、连我自己的站点做一次健康检查。

站点的响应时间、身份、权限,都对。

这一步是整个晚上最值钱的二十分钟。它证明的不再是我这台机器上能跑,换成了任何人拿到这个包、在他自己的环境里也能跑。这两种证明在审核面前完全不是一个分量。我前面所有的自信,都建立在第一种上,而它恰好是最弱的一种。

七、还有一页,我盯着看了很久

授权配置那页上面还有两栏,一栏叫发起请求白名单,一栏叫回调地址白名单,里头预填了几个平台自己的域名。

我盯着这两栏看了半天,总觉得不填会被卡。后来把页面开头那句话读了三遍才反应过来,它写的是远程服务端认证连接器请完成本页授权跳转。跳转、回调,这两个词已经把适用范围说清楚了。我这种跑在本地、用户自己填凭证的,全程没有浏览器跳转,也没有回调地址。

那两栏对我没有意义。它是给另一种形态准备的,留着默认值就行,不影响审核。这种看不懂就先填上的冲动,最好掐掉,填错了反而给自己添新的疑点。

八、写在最后

回头看,卡住我的不是技术,是信息不对称。平台把七八种失败都归到同一句话里,你在外面只能猜,猜错就白补一轮。

几条我记下的,也给别人省点时间:

  • 报错要照着它做了什么去倒推,别照着它说了什么去猜。同一句话能对应好几种成因,本地能跑只排掉其中一种。
  • 本地跑通是最弱的证明。解压到空目录里再跑一遍,成本极低,能排掉一大半问题。
  • 平台给的提示,常常和我以为的不是同一条。它说授权没配好,可能只是说它起不来。
  • 记录查不到,先确认自己站在哪个主体下面看。东西挂在团队名下,个人消息那一栏永远是空的。

我自己也绕过一个大弯。中途一度想过去公共仓库发个npm包,让平台到时候自己去取,还真的查了半天怎么发布,卡在登录和令牌上,我自己的家宽ip地址竟然被判定为机器人,简直要疯了。后来我才想明白,我要发的是开放平台,代码放在哪儿根本不是它管的事。那句话我早该问自己一遍。

这一下午时间都花在猜和补之间打转。真正省时间的做法是少猜,先看证据。这个道理我写到这儿才顺过来。

现在包在等下一次审核。一天就这么过去了,权当记录。



微信扫描下方的二维码阅读本文

赞(0) 赞赏
版权声明:本文采用知识共享 署名4.0国际许可协议 [BY-NC-SA] 进行授权,转载请联系作者。
文章名称:《本地跑得好好的,一上架就折腾:记一次 WorkBuddy 连接器上架》
文章链接:https://wangjunwei.com/website/1330.html
本站资源仅供个人学习交流,请于下载后24小时内删除,不允许用于商业用途,否则法律问题自行承担。

评论 抢沙发

觉得文章有用就打赏一下文章作者

非常感谢你的打赏,我们将继续给力更多优质内容,让我们一起创建更加美好的网络世界!

微信扫一扫

登录

找回密码

注册