发生了什么

换电业务里,回收回来的电池要先在仓库做一次签收检测,才算完成交接。检测在手机端的页面上操作:页面要求填收件联系人的姓名和联系电话,填完提交,这次签收才继续往下走。可以把它理解成一张电子签收单,姓名和电话是必填项。

这个页面不是纯原生页面,而是跑在 App 里的一个容器中,也就是常说的小程序容器:App 提供外壳,页面用网页技术写,输入框、按钮这类控件由容器提供。容器里的输入框有两种渲染方式:默认交给手机的原生控件渲染;也可以关掉原生渲染,改用网页自己的输入框,由网页输入框唤起系统键盘。

正常流程是:打开签收页,点姓名或电话输入框,键盘弹出,输入内容,提交。

这次的前提变化在安装包本身。iOS 端的新版本为了满足应用商店对构建方式的新要求,改用新版构建工具打包。打包方式换了之后,容器里输入框组件原来那条原生渲染通路在新包里不再被支持:点输入框时键盘弹不出来,光标也进不去,用户看到的就是一直写不了姓名和电话。表单有必填项填不进去,整张单就停在提交之前。

这个兼容问题不是第一次出现。另一条同样使用这个容器的业务线,在更早的版本里就报过;当时的结论是需要把输入框降级成网页渲染,升级注意事项里也点名了输入框和多行文本框要重点回归。这次这条业务线的页面没有按结论改,从结果看这轮验证也没有覆盖到签收表单,同样的现象就在新包里又出现了一次。

记录里能确认的反馈只有一条,来自仓库签收检测这条线;有多少人受影响、持续了多久,记录没有统计。处置方式是紧急修复发版:在用到输入框的地方显式关掉原生渲染,涉及两个业务端和两个公共组件库。修复是否已经验证通过,记录没有说明。

本质

问题出在“不写就用默认”这条隐形约定上。

  1. 页面调用容器的输入框时,大多没有声明渲染方式,组件就按默认值走原生渲染,由手机的原生控件负责唤起键盘。页面平时能正常用,是因为这条默认通路一直是通的。
  2. 新版本换了构建工具。打包方式变了之后,容器里这条原生渲染通路不再被支持,而组件的默认值没有跟着变,页面自己也没有声明渲染方式。
  3. 于是点输入框时,本该由原生控件唤起的键盘不弹了,光标进不去,输入的内容没有地方落。用户反复点,页面没有任何提示,只会以为是自己手机或网络的问题。
  4. 签收表单是姓名、电话加提交,任一必填项填不进去,整张单就停在原地,签收做不完,后面的交接也走不下去。
  5. 更麻烦的是影响面。输入框在多个业务端和公共组件库里都有封装,凡是没声明渲染方式、又在新包里用到容器输入框的页面,都有同样的风险,不会只坏一个页面。

升级只换了打包方式,页面仍在按默认的渲染方式调用输入框,而这条通路在新包里已经不通,整批表单就这样一起失灵。

修复方向是:在所有使用输入框的地方显式声明不使用原生渲染(把 enableNative 设为 false),改用网页输入框接输入;公共组件库按需把默认值一起调整,避免调用方逐页漏改。这里要注意,组件库改默认值会影响所有调用方,得先确认没有页面依赖原生渲染的特殊行为,改完按页面清单回归,而不是只改出事的那一个页面。记录没有说明修复后的验证结果。

下面两段代码是脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现。

错误代码

// 签收检测页的表单项(脱敏教学示例,页面跑在小程序容器里)
// 输入内容由页面统一的变更处理函数接收,这里只关心输入框用哪种渲染方式
function renderSignForm(form) {
  return `
    <view class="form">
      <!-- 为什么错:没有声明渲染方式,组件按默认值走原生渲染,
           而新版构建工具打出来的容器里这条通路已经不支持 -->
      <input value="{{contactName}}" placeholder="联系人姓名" />
      <!-- 为什么错:电话输入框照抄同一写法,问题会一模一样地出现,
           两个必填项都填不进去,表单最终无法提交 -->
      <input value="{{contactPhone}}" placeholder="联系电话" />
      <button>提交</button>
    </view>`;
}

修复代码示例

// 同一表单:逐个输入框显式改走网页渲染(脱敏教学示例)
function renderSignForm(form) {
  return `
    <view class="form">
      <!-- 修复:enableNative 设为 false 关掉原生渲染,改用网页内的输入框,
           键盘由网页输入框唤起,不再依赖原生控件 -->
      <input enableNative="{{false}}" value="{{contactName}}"
             placeholder="联系人姓名" />
      <!-- 修复:电话输入框做同样声明,两个必填项都落到同一条可用的通路上 -->
      <input enableNative="{{false}}" value="{{contactPhone}}"
             placeholder="联系电话" />
      <button>提交</button>
    </view>`;
}

下次遇到这些场景要警惕

  • 换构建工具、升级系统或容器 SDK 时:先把升级说明里点名的组件(输入框、多行文本框、弹层类控件)列成页面清单,逐页确认调用方式和渲染方式,看每个输入框是否都声明了一条在新包里可用的通路,不要只跑一遍主流程就认为回归完了。
  • 用新包在真机上检查输入:把每个输入框都点一遍,观察键盘是否弹出、光标能否进入、输入内容能否回填、提交时是否带上值;只在模拟器或旧安装包上验证,覆盖不到这类问题。
  • 改公共组件库的默认值时:先列出所有调用方,按需切换而不是一刀切;改完重点回归嵌在弹层、列表和可滚动区域里的输入框,这些位置的输入行为最容易和默认值绑死。
  • 收到“点了没反应”的反馈时:先分清是点击事件没触发、键盘没弹出来,还是值没有回填,再判断是不是渲染通路不兼容;否则容易一上来就怀疑网络或接口,绕远路。