支付宝生活号与小程序是两套独立环境，uni-app需通过H5构建模式并条件编译适配：生活号用ap.* API、HTTPS白名单、SDK加载及服务端换token，不可直接运行小程序包。
支付宝生活号和小程序是两套独立运行环境
uni-app 编译出的产物默认只能跑在支付宝小程序容器里，不能直接用于生活号。生活号本质是 H5 页面，运行在支付宝客户端内置 WebView 中，不支持 my.* 原生 API，也不识别 pages.json 或 manifest.json 里的小程序专属配置。
常见错误现象包括：页面白屏、my.getAuthCode 报错 undefined、my.request 失效、路由跳转失败。这些都不是代码写错了，而是运行环境根本不对。
- 生活号页面必须通过
https协议加载，且域名需在支付宝开放平台「生活号」后台完成备案与 HTTPS 白名单配置 - 不能使用
uni.navigateTo等小程序路由 API；应改用window.location.href或my.navigateTo（仅限跳转到同域内其他生活号页面） - 授权登录必须走生活号专属流程：调用
ap.getAuthCode（注意是ap，不是my），且需提前引入 SDK：<script src="https://gw.alipayobjects.com/as/g/h5-lib/alipayjsapi/3.1.1/alipayjsapi.min.js"></script> - 生活号中无法调用
my.faceVerify等原生生物识别能力，人脸识别需降级为服务端比对或引导用户跳转至小程序完成
如何复用 uni-app 代码跑在生活号里
核心思路是「一套源码，双构建目标」：把 uni-app 当作 Vue 项目来用，禁用小程序特有逻辑，启用 H5 构建模式，并手动桥接支付宝 H5 API。
关键操作包括：
- 构建命令必须用
npm run build:h5，而非npm run build:alipay；后者产出的是小程序包，对生活号完全无效 - 在
vue.config.js中显式关闭小程序相关 loader 和插件，避免编译时注入my.*调用 - 所有支付宝能力调用需包裹条件编译：
#ifdef H5下走ap.*，#ifdef MP-ALIPAY下走my.*；二者不可混用 - 生活号的用户信息获取依赖
ap.getAuthCode返回的authCode，后端需调用支付宝alipay.system.oauth.token接口换user_id，不能复用小程序的my.getOpenUserInfo
生活号授权登录的最小可行实现
很多团队卡在“点了按钮没反应”，往往是因为 SDK 加载时机或作用域问题。以下是最简可运行片段：
<template>
<button @click="login">授权登录</button>
</template>
<script>
export default {
methods: {
login() {
// #ifdef H5
if (window.ap && typeof window.ap.getAuthCode === 'function') {
window.ap.getAuthCode({
scopes: ['auth_user'],
success: (res) => {
this.$emit('auth-success', res.authCode)
},
fail: console.error
})
}
// #endif
}
}
}
</script>
注意：window.ap 不是全局变量，必须等 SDK 加载完成才能调用。建议在 index.html 的 中同步加载脚本，并加 defer 属性确保执行顺序。
容易被忽略的兼容细节
生活号和小程序看似都是支付宝生态，但它们的 CSS 渲染、事件冒泡、字体加载、本地存储行为都存在细微差异。最常踩的坑是：
-
localStorage在生活号中受同源策略严格限制，跨子域（如a.example.com和b.example.com）无法共享；而小程序的uni.setStorageSync是沙箱隔离的，两者数据完全不互通 - 生活号不支持
uni.showToast，需自行实现轻提示组件，或用ap.showToast（注意该 API 仅部分版本客户端支持） - 支付宝客户端对生活号页面的首屏渲染有性能要求，超过 3 秒未完成会触发白屏 fallback；建议移除非关键 JS，拆分大 bundle，避免在
mounted中发起多轮请求 - 调试必须用真机 + 支付宝客户端「扫一扫」打开，开发者工具的生活号模拟器经常不准确，尤其是授权流程
真正难的不是写代码，而是时刻记住：你写的不是“一个 uni-app 应用”，而是“两个不同环境下的同一套业务逻辑”。环境切换时，连 console.log 都可能输出到不同地方。
