常见问题
收藏我的收藏
收藏罗列常见问题并提供解决方法。
使用 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”
解决办法：升级到最新版的开发者工具。
解决办法：点击下图中模拟器的按钮，使用一个真实的抖音账号扫码并授权。后续所有需要用户登录态的接口，返回值都将与抖音客户端一致（包括 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 版本及以上。
文档评论
