uni-app开发踩坑记录：新手必看的常见问题与解决方案

在uni-app开发中，总会遇到一些让人头疼的问题。本文整理了一些常见的坑和解决方案，希望能帮助大家少走弯路。

1. 页面相关问题

1.1 页面返回数据刷新问题

问题描述：
从A页面跳转到B页面，在B页面修改了数据后返回A页面，发现A页面的数据没有更新。

解决方案：

使用事件总线：

// 在B页面修改数据后发送事件
uni.$emit('updateData', { data: '新数据' })

// 在A页面监听事件
onShow() {
  uni.$on('updateData', this.handleUpdate)
},
onHide() {
  uni.$off('updateData', this.handleUpdate)
}

使用页面生命周期：

// 在A页面的onShow中刷新数据
onShow() {
  this.loadData() // 重新加载数据
}

1.2 页面返回卡顿问题

问题描述：
使用uni.navigateBack返回上一页时出现明显卡顿。

解决方案：

检查页面是否有大量数据或复杂计算
使用分页加载代替一次性加载
在返回前清理不必要的定时器和监听器
避免在onShow中进行耗时操作

2. 样式兼容问题

2.1 不同平台样式差异

问题描述：
同样的样式在不同平台（iOS、Android、H5）显示效果不一致。

解决方案：

使用flex布局代替固定宽高
避免使用复杂的CSS3特性

使用条件编译处理平台差异：

/* #ifdef H5 */
.box { height: 100vh; }
/* #endif */
/* #ifdef MP */
.box { height: 100%; }
/* #endif */

2.2 滚动穿透问题

问题描述：
弹窗打开时，背景页面仍可滚动。

解决方案：

弹窗打开时给body添加类：

// 打开弹窗时
document.body.style.overflow = 'hidden'
// 关闭弹窗时
document.body.style.overflow = 'auto'

使用@touchmove.prevent阻止滚动：

1	<view class="mask" @touchmove.prevent></view>

3. 网络请求问题

3.1 请求超时处理

问题描述：
网络请求偶尔超时，导致页面卡死。

解决方案：

设置合理的超时时间
添加重试机制

显示加载提示和错误提示：

uni.showLoading({
  title: '加载中...'
})

try {
  await this.loadData()
} catch (e) {
  uni.showToast({
    title: '加载失败，请重试',
    icon: 'none'
  })
} finally {
  uni.hideLoading()
}

3.2 登录失效处理

问题描述：
token过期后继续请求接口导致报错。

解决方案：

统一处理token过期：

// 请求拦截器中处理
if (response.code === 401) {
  // 清除登录信息
  uni.clearStorageSync()
  // 跳转登录页
  uni.reLaunch({
    url: '/pages/login/index'
  })
}

4. 性能优化问题

4.1 图片加载优化

问题描述：
页面中图片较多，加载慢且占用内存。

解决方案：

使用懒加载：
1
<image :src="url" lazy-load></image>
压缩图片
使用CDN加速
预加载重要图片

4.2 列表卡顿问题

问题描述：
长列表滚动时出现卡顿。

解决方案：

使用分页加载
避免在滚动时进行复杂计算
使用骨架屏优化体验
减少不必要的数据绑定

5. 小程序相关问题

5.1 包体积超限

问题描述：
小程序打包后提示超出大小限制。

解决方案：

使用分包加载
压缩图片和资源文件
删除未使用的组件和文件
使用CDN加载大文件

5.2 微信授权问题

问题描述：
获取用户信息时授权弹窗显示不出来。

解决方案：

使用button触发授权：

1
2
3

<button open-type="getUserInfo" @getuserinfo="handleGetUserInfo">
  获取用户信息
</button>

检查是否已授权：

uni.getSetting({
  success: (res) => {
    if (!res.authSetting['scope.userInfo']) {
      // 未授权，显示授权按钮
    }
  }
})

6. 开发工具问题

6.1 HBuilderX卡顿

问题描述：
HBuilderX运行缓慢，经常卡死。

解决方案：

关闭不需要的项目
定期清理缓存
更新到最新版本
增加内存分配

6.2 真机调试问题

问题描述：
真机调试时连接不上设备。

解决方案：

检查USB调试是否开启
更新手机驱动
更换数据线
重启开发工具和手机

7. 总结建议

多看官方文档和更新日志
保持良好的代码习惯
做好版本管理
常见问题记录总结
定期更新开发工具

如果觉得文章对你有帮助,欢迎点赞、评论、分享,你的支持是我继续创作的动力！