Uniapp开发多端项目发布前，需要区分H5、小程序、App的接口环境、登录状态、静态资源路径差异，梳理请求封装、权限校验、异常提示、平台专属API等检查项，降低上线后多端兼容故障。
区分多端接口环境，避免测试地址泄露上线
Uniapp最大优势是一套代码同时编译到H5、微信小程序、App、其他小程序平台，但不同端的网络环境、域名限制完全不一样，这也是上线最容易踩坑的地方。很多开发在本地调试时直接写死测试接口地址，打包发布后忘记切换正式环境，导致线上全部请求指向测试服务器，引发业务异常。
推荐按平台、环境做配置隔离，区分开发、测试、生产三套接口域名。小程序有域名白名单限制，所有后端接口、上传域名都需要提前在小程序后台添加到request合法域名，并且要求HTTPS；H5端受浏览器跨域策略约束，需要后端配置跨域头或者使用代理；App端在默认情况下域名限制宽松，但正式版本同样建议使用HTTPS协议，保障传输安全。
打包前增加环境判断逻辑，通过uni.getSystemInfoSync或者条件编译#ifdef、#endif区分平台，不要手动全局搜索替换接口地址，人工修改很容易遗漏页面。同时关闭控制台log打印，避免线上版本输出敏感参数、token等信息，减少信息泄露风险。
登录态与Token在不同端的存储差异
登录凭证、Token的存储方式，在各个平台并不通用。H5一般使用localStorage或者cookie保存登录信息；小程序使用uni.setStorageSync本地缓存，同时受小程序缓存大小、清理机制影响；App端可以使用storage，也可以选择更稳定的plus存储方案。如果代码不做适配，就会出现一端登录正常、另外一端登录状态很快丢失的情况。
统一封装登录、获取token、退出登录的工具方法，内部做好平台分支处理。同时注意token过期处理，统一捕获401、403鉴权返回码，自动引导用户重新登录，不要只在单个页面写过期判断。小程序还要留意登录时效、用户授权更新，比如用户重新授权、手机号授权场景，及时刷新登录凭证。另外，前端不要在本地做权限硬判断，核心权限校验必须放在后端接口，防止前端绕过权限控制。
资源路径、图片上传与静态资源适配
Uniapp里面的静态资源路径是高频出错点。本地开发正常的图片、视频、附件地址，换到小程序或者App之后可能加载失败。静态资源建议优先使用相对路径，避免直接写本地绝对路径；网络图片全部使用HTTPS地址，小程序不支持HTTP资源，会直接拦截图片加载。富文本内容更需要单独处理，很多后端返回的富文本包含http图片、宽高样式，在小程序里会出现排版错乱、图片无法展示。
文件上传逻辑也要分平台测试。小程序上传接口同样需要配置上传合法域名，同时有单文件大小、并发限制；App上传可以支持更大文件，但是要做好进度回调、超时重试；H5上传受浏览器限制，需要监听文件类型、大小校验。上传完成后的返回资源地址，统一返回标准可跨端访问的URL，不要返回仅内部可访问的内网地址。
平台专属API与条件编译校验
很多API是平台独有的，比如小程序的订阅消息、微信登录、小程序码，App的推送、原生弹窗、文件管理，H5的浏览器分享。如果没有用条件编译隔离，其他端打包之后会直接报错。上线前需要梳理项目中所有用到的平台特有能力，用#ifdef #ifndef做包裹，没有该能力的端提供降级方案。
以分享功能举例：小程序使用原生分享接口，H5可以用网页分享或者引导复制链接，App调用原生分享面板。不能假设所有平台都支持同一套分享代码。地理位置、相机、相册等权限，各个平台的授权弹窗、拒绝后的处理逻辑也不一样，需要单独测试用户拒绝授权后的页面表现，避免直接卡死。
网络异常、加载状态和用户反馈体验检查
多端网络环境复杂，用户可能处于弱网、无网、信号切换场景。接口请求必须统一增加超时时间，增加loading加载状态，避免用户重复点击提交。请求失败后给出友好文字提示，区分网络失败、服务报错、参数错误，不要只抛出一串后端错误码给用户。
表单提交是重灾区，一定要做防抖，防止短时间多次提交产生重复订单、重复数据。列表页面下拉刷新、上拉加载更多，在小程序、App、H5滚动容器表现不一样，部分机型会出现触底不触发、反复加载的问题，需要在多款真机上验证。空数据页面也要统一兜底样式，接口返回空列表时展示空状态提示，不要直接空白一片。
真机测试，不要只依赖模拟器
模拟器、H5浏览器预览只能完成基础功能验证，很多兼容性问题只会出现在真机上。小程序要在微信开发者工具预览，同时在安卓、苹果真机扫码测试；App需要打测试包，分别在不同系统版本手机安装测试；H5在微信内置浏览器、手机自带浏览器、多款主流浏览器打开验证。
重点检查字体、样式、弹窗层级，部分机型的rpx、vh单位会有渲染差异；键盘弹出遮挡输入框，是移动端非常普遍的问题，需要监听键盘高度自动调整页面布局。同时测试深色模式、系统字体放大之后页面会不会错乱溢出。
上线打包、版本与灰度准备
打包前核对应用名称、图标、启动页、隐私协议、权限申请说明。小程序提交审核前检查类目、服务类目是否匹配功能，避免审核驳回；App上架应用商店需要准备对应的资质、隐私说明；H5发布后检查服务器HTTPS、跨域配置、缓存策略。
上线之后建立日志收集机制，前端异常、接口报错可以上报后端，方便快速定位不同端的独有问题。有条件的项目可以先小范围灰度发布，收集用户反馈，确认稳定之后再全量放开。一套代码做多端，核心不是写更少的代码，而是提前识别各个平台的差异点，统一规范接口和交互，减少上线之后各种零散的兼容bug。