数据库性能优化与故障排查实战指南
2026/10/27 10:57:41
提示：文章写完后，目录可以自动生成，如何生成可参考右边的帮助文档
文章目录
- 前言
- 一、吐槽一下
- 二、申请个人发布标识符（最关键）
- （1）去认证
- （2）项目内填写标识符
- 三、修复 Hub 许可证缓存
- 4. 彻底清理项目旧缓存（必做，旧 Library 会携带试用标记）
- 四、重新打包 WebGL
- 五、常见踩坑点
- 六、出现 `The project has mix usages which violates EULA` 日志
- 七、查看日志
- 总结
前言
团结啊团结…
为啥我要用团结？就像买手机，买车一样，我就是那种爱支持国货的大冤中。
含义：Not for release（非发布版本）、Trial version（试用版水印），不是启动页 Splash Logo，是运行时页面弹出 / 叠加的水印，核心原因：项目未完成个人版发布标识符认证、本地许可证缓存异常、许可证混用、打包缓存残留。
一、吐槽一下
团结啊团结
二、申请个人发布标识符（最关键）
（1）去认证
标识符不能有中文、空格，只能英文、数字、点，格式类似：com.xxx.mywebgl
浏览器打开：链接: 申请项目标识符，或者如下图：
点击“去认证”，就会弹出一个网页，如下图（填写完成即可）：
（2）项目内填写标识符
Edit → Project Settings → Player → Other Settings
- WebGL 平台下，勾选Override Default Bundle Identifier
- 填入刚才申请拿到的标识符，必须一字不差，保存项目设置
Ctrl+S。 - 回到团结 Hub，看该项目状态变为已认证，如果还是 “去认证” 等待 30 秒。
❗ 如果这里包名和网页申请的不一致，打包 WebGL 一定会出水印。
三、修复 Hub 许可证缓存
- 关闭全部团结编辑器、关闭 Tuanjie Hub
- 打开 Hub → 设置 → 许可证管理 →退还许可证
- 重新登录账号，重新获取「团结引擎个人版」许可证，确认是个人版，不要混有 Pro 试用许可。
4. 彻底清理项目旧缓存（必做，旧 Library 会携带试用标记）
关闭编辑器，项目目录手动删除：
关闭团结引擎，删除项目目录下的 Library 和 Temp 文件夹（缓存文件）。
Library（最重要，授权缓存在这里）Temp- 旧的 WebGL 打包输出文件夹（Build）
重新打开项目，进入“Build Settings”，勾选“清理构建缓存”后重新打包。
再从 Hub 重新打开项目，等待 Library 完整重生成，不要中途关闭编辑器
四、重新打包 WebGL
- 切换平台为 WebGL，等待平台切换完成
- Build，输出全新文件夹，不要覆盖旧打包目录
- 测试：不要直接双击 index.html 打开（本地 file 协议部分授权校验异常），必须起 http 服务访问 WebGL（vscode Live Server、nginx）查看水印是否消失。
⚠️ 直接 file:// 打开 WebGL，有时会误报水印，http 服务才是真实发布环境
五、常见踩坑点
- 账号不一致：申请标识符的账号 ≠ Hub 登录账号 → 一定出水印，必须同一个 Unity ID 账号。
- 混用 Pro 试用许可：曾经激活过团结 Pro 试用版，即使切回个人版，缓存残留会打出 Trial 水印；执行退还许可证再重拿个人许可。
- git 拷贝别人项目：拷贝过来的项目带别人旧 Library 缓存，必须删除 Library 再打开。
- 云构建打包：如果使用团结云构建，不要上传 Library 目录，云构建需要在云平台绑定项目标识符，否则云打包依然带水印Unity…。
- 区分：运行时 Not for release 水印 ≠ Splash 开机动画 Logo
- Not for release：运行时悬浮水印，靠标识符认证消除；
- Splash Logo：启动页团结引擎 logo，个人版不能关闭，是合规显示，不属于 Trial 水印
六、出现The project has mix usages which violates EULA日志
打包日志出现这句：资产来自别的许可证账号导入，需要删除问题资源，用当前已认证账号重新导入资源再打包
七、查看日志
（1）方式一：编辑器直接打开（最简单，推荐）
- 团结编辑器顶部菜单：
Window → General → Console打开控制台窗口 - 点 Console 窗口右上角的小齿轮旁边下拉菜单 →Open Editor Log
直接打开Editor.log文本文件，整个 WebGL 打包全过程、许可证校验、mix usages警告全部在这里。
✅ 打包完成后立刻点这个，就是本次打包完整日志。搜索关键词：
license、watermark、Trial、mix usages快速定位水印相关信息。
方式二：磁盘物理路径 Windows（团结引擎 Tuanjie）Editor.log（编辑器打包日志）
C:\Users\你的用户名\AppData\Local\Tuanjie\Editor\Editor.log许可证单独日志（排查许可异常）
C:\Users\你的用户名\AppData\Local\Tuanjie\Tuanjie.Licensing.Client.logAppData 默认是隐藏文件夹：文件管理器【查看】→勾选【隐藏的项目】即可看到。
（3）WebGL 打包运行之后的日志（浏览器端）
WebGL 没有本地日志文件，全部输出浏览器控制台：
- http 服务打开打包后的 index.html
- F12 → Console 面板，可以看运行时水印相关提示
总结
团结啊团结。。。