常见问题

罗列常见问题并提供解决方法。

开发时，调试器的控制台打印红色错误信息，小程序自抖音1960版本起，自定义导航栏仅对拥有权限的开发者开放预览或者真机调试受到阻塞，提示类似的报错内容。

影响版本：控制台错误信息影响 3.3.0 及以上版本；预览或真机调试影响全版本。

解决办法：在开放平台的后台中申请 custom-自定义导航栏权限 。申请路径：功能管理-页面结构自定义，具体申请规范请查阅小程序页面结构自定义能力开通规范。

原因：参看 小程序页面结构升级重要通知 。

预览或者上传时，提示 没有相关权限 等错误信息。

解决办法：请小程序的拥有者给当前开发者设置上传预览的权限。

原因：小程序的上传预览需要权限设置。建议在【管理后台】>【设置】>【团队协作】>【协作者】中检查当前用户对小程序的权限设置。

项目使用 uni-app 进行多平台开发。在微信开发者工具中预览时正常，但是在字节开发者工具中预览失败，报错信息是 包体积过大 。

解决办法：uni-app 构建对应平台产物时使用 NODE_DEV=production ，简化 source map 。

原因：参看 uni-app 的产物体积踩坑记录 。

模拟器中的页面上下滚动失败。预览、真机调试时，手机扫码后能够正常滚动。

解决办法：升级到最新版的开发者工具。

原因：模拟器功能缺陷，在新版本中已修复。

模拟器中页面导航时，调试器会打印多余的 warning 日志，timestamp: Date.now() / TIMESTAMP_ADD_ON 。

影响版本： 3.2.5 及以下版本。

解决版本：升级到最新版开发者工具。

原因：功能缺陷，在新版本中已修复。

编辑 TTML 文件时，内联样式 style background 图片地址提示报错，详情参看社区帖子

解决办法：编写时将 url 内的所有内容用引号包裹。

原因：语法校验时无法正确识别插值括号的内容，需要用引号包裹。

预览时因为包体积而报错。主包大小 XX （大于 4 的数字） MB，大于 16 MB。

影响版本： 3.2.5 及以下版本。

解决办法：降低主包体积到 4 MB 之下。

原因：文案错误，引起误解。分包项目的主包限制为依然 4 MB 。文案问题在 3.2.6 版本中已修复。

预览时正常，但是上传失败。报错信息包含 u.append is not a function。

影响版本： 3.2.4 及以下版本。

解决办法：小程序开发者后台-设置-基础设置-功能信息-小程序基础库版本-调整最低基础库版本至 1.88.0 版本及以上

原因：参看 关于开发者工具云端编译策略升级通知。

预览失败，报错信息包含 unzip error 。

影响版本：3.1.x 等版本。

解决办法：升级到最新版的开发者工具。