常见问题
收藏
我的收藏

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

使用 uni-app 开发小程序时，在 pages.json 中定义了编译模式，当编译到抖音小程序时，编译模式的下拉列表没有同步更新

原因：在pages.json的定义的编译模式在编译完成后被写入到了project.config.json文件，如果project.private.config.json文件也存在编译模式配置，IDE 则将优先读取project.private.config.json中的配置。

解决办法：

方法一(推荐)：

避免在pages.json文件中定义编译模式，直接在抖音开发者中新增或更新编译模式。

方法二：

在详情->工程配置中取消勾选"是否开启私有配置"，防止 IDE 读取project.private.config.json中的配置（但可能会导致 urlCheck 等配置在重新编译后被重置）。

担保交易或交易系统 2.0 调试报错：“createMerchantOrder：fail 请求中用户 uid 为 0”、“tt.createOrder:fail user not login”

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

原因：为了方便开发者开发，我们给每一个“开发者账号”指定了一个“模拟抖音账号”。这个“模拟抖音账号”只能用于一些简单的 API 验证，需要进行业务测试时，它无法走通完整流程。在调试担保交易或者交易系统 2.0 时，均要求使用真实抖音账号的信息。

解决办法：点击下图中模拟器的按钮，使用一个真实的抖音账号扫码并授权。后续所有需要用户登录态的接口，返回值都将与抖音客户端一致（包括 openid、unionid、昵称、头像、手机号、订单等）。

注意：请保护自己的抖音账号的敏感信息。

详细操作可以参考：模拟器使用指南

使用 uni-app 开发，每一次编译后都需要在 IDE 重新设置配置

原因：uni-app 重新编译后都会重新生成project.config.json文件，导致在 IDE 中的设置被覆盖

解决办法：

注意：从 IDE 4.0.7 版本开始已经支持了私有配置功能，可尝试升级版本解决该问题，具体文档可参考私有配置。

方法一：在 uni-app 源码工程下的manifest.json文件中字节跳动小程序配置进行小程序的配置设置，但 uni-app 只支持部分设置，若有其他配置需求，可使用方法二

方法二：通常情况下，uni-app 编译后会将产物输出到unpackage/dist/dev/mp-toutiao目录下，可以在dev目录下(与mp-toutiao目录同级)创建project.config.json文件，文件内容可参考

{
  "projectname": "demo",
  "miniprogramRoot": "mp-toutiao"
}

将unpackage/dist/dev目录导入到小程序 IDE 中就能进行正常配置了

注意：新增的project.config.json文件根据实际情况调整存放地址

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

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

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

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

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

原因：小程序的上传预览需要权限设置。建议在【控制台】-右上角【账号中心】-【成员协作】中检查当前用户对小程序的权限设置。

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

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

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

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

Apple 无法检查 App 是否包含恶意软件

原因：由于 Mac 操作系统原因，可能会异常出现该错误。

解决方法：参考macOS 使用手册，打开“系统设置”中的“隐私与安全性”选择“仍要打开”即可。

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

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

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

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

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

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

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

Windows 模拟器打不开，控制台有报错

原因：系统缺少 Microsoft Visual C++ 必要组件。

解决办法：安装 https://aka.ms/vs/17/release/vc_redist.x64.exe 后重启开发者工具。

常见问题收藏我的收藏