当 Tiny Cloud 检测到问题时,它会显示一个包含问题信息的编辑器通知。本文档介绍了常见 Tiny Cloud 错误通知的原因和解决方案。
此处显示的通知措辞可能与 Tiny Cloud 实际显示的通知有所不同。
无效的 API 密钥
"继续使用 TinyMCE 需要有效的 API 密钥。请通知管理员检查当前的 API 密钥。点击此处了解更多。"
原因
出现此通知的情况如下:
脚本标签中未提供
apiKey,提供了空的或丢失的
apiKey,或Tiny Cloud 服务器上找不到提供的
apiKey。
apiKey 必须满足:
长度精确匹配,
由特定字符组成,并且
使用 Tiny Account 页面 上的 Tiny Cloud 账户创建。
例如:
<script src="https://cdn.tiny.cloud/1/abcd1234/tinymce/8/tinymce.min.js" referrerpolicy="origin" crossorigin="anonymous"></script>
在这种情况下,编辑器将处于只读状态,并显示一条通知:"继续使用 TinyMCE 需要有效的 API 密钥。请通知管理员检查当前的 API 密钥。点击此处了解更多。”
解决方案
要解决此问题:
更新
srcURL 以包含您的(网站或应用程序开发人员的)Tiny Cloud API 密钥,通过将占位符no-api-key替换为实际的 API 密钥。例如:如果您的 API 是
abcd1234:<script src="https://cdn.tiny.cloud/1/abcd1234/tinymce/8/tinymce.min.js" referrerpolicy="origin" crossorigin="anonymous"></script>
检查脚本标签中提供的
apiKey:删除任何前导或尾随空格。
删除
apiKey中不存在的任何其他字符。如果您使用变量替换,请确保变量正确替换。确保
apiKey+与 https://www.tiny.cloud/my-account 上显示的 API 密钥匹配。
如果您没有 API 密钥,或者需要检索现有密钥,请访问:Tiny Cloud。
访问我们的 无效 API 密钥 页面,了解有关如何解决 TinyMCE 无效 API 密钥 问题的更多信息。无 API 密钥
"继续使用 TinyMCE 需要有效的 API 密钥。”(控制台消息)
原因
当 apiKey 设置为 no-api-key 时,编辑器将处于只读状态,用户将看到一个"完成设置"对话框,提示他们添加有效的 API 密钥、配置域名并探索高级功能。

解决方案
更新
srcURL 以包含您的(网站或应用程序开发人员的)Tiny Cloud API 密钥,通过将占位符no-api-key替换为实际的 API 密钥。
例如:如果您的 API 是 abcd1234:
<script src="https://cdn.tiny.cloud/1/abcd1234/tinymce/8/tinymce.min.js" referrerpolicy="origin" crossorigin="anonymous"></script>
要检索 API 密钥或注册 API 密钥,请访问:Tiny Cloud。
域名未注册
"该域名未在 TinyMCE 客户门户中注册。请通知管理员将其添加到已批准的域列表中,以便继续使用 TinyMCE。点击此处了解更多。"
原因
当页面的 Referer 与您 apiKey 下存储的已批准域名列表不匹配时,会显示此通知。Tiny Cloud 通过检查网络请求中的 Referer 头部的域名部分来验证 TinyMCE 加载的域名。您可以在 Tiny Account 上查看已批准域名的列表。
有时 Referer 头部中的域名与浏览器地址栏中的 URL 不匹配。要检查 Referer 头部:
打开浏览器的 开发者工具。
打开 网络 选项卡。
查找并选择使用您的 API 密钥从 Tiny Cloud 加载 TinyMCE 的请求。
单击 标头 选项卡。
在名为请求标头的部分中,应该有一个 Referer 字段。这是 TinyMCE 用来与您的已批准域名进行比对的数值。它必须与您 Tiny Account 上列出的已批准域名之一匹配。
解决方案
如果 Referer 对于该站点是正确的,请确保该域名包含在 Tiny Account 上的已批准域名列表中。如果 Referer 不是您预期的,您可能需要调整应用程序的 Referer 头部 设置。
缺少 Referer 头部
"我们无法检查您的域名,因为缺少 referer 头部。请阅读指南以确保您的 referer 头部存在,然后我们可以为您定制编辑器体验。"
原因
如果在从 Tiny Cloud 加载 TinyMCE 的网络请求中缺少 Referer 头部,则会显示此通知。Tiny Cloud 通过检查网络请求中 Referer 头部的域名来验证 TinyMCE 加载的域名。
Referer 头部有时会因浏览器设置或浏览器扩展而被移除。Tiny Cloud 只需要 Referer 头部中的域名,因此为了提高性能和隐私性,Tiny 建议在请求 Tiny Cloud 资源时将
referrerpolicy设置为origin。
解决方案
确定是哪个浏览器设置或扩展负责阻止发送Referer。常见的扩展是 Referer Control:
一旦确定了设置或扩展,请修改它以允许仅发送 Referer 的 Origin。或者,禁用使用 Tiny Cloud 的任何页面的扩展或设置。
高级插件故障排除
"_ 高级插件未在您的 API 密钥上启用。升级您的账户。”
原因
当您的 API 密钥无法访问所请求的高级插件时,会显示此通知。这可能是由于试用版过期,而您的 TinyMCE 配置试图加载您不再可以访问的高级插件。
如果您使用了错误的 API 密钥,也可能看到此通知。请确保您使用的是具有正确权限的 API 密钥。
解决方案
要么从 TinyMCE 配置中删除高级插件,要么升级您的订阅以获得对该高级插件的访问权限。
访问我们的 无效 API 密钥 页面,了解有关如何使用 TinyMCE 修复 无效 API 密钥 的更多信息。只读模式 - 无 API 密钥
"TinyMCE 处于只读模式。请通知管理员继续使用需要 API 密钥。了解更多
原因 "无 API 密钥(只读模式)"
当开发人员未提供 API 密钥时会发送此消息,通常是因为他们复制了入门脚本但未完成官方的 注册 流程以获取 API 密钥。
解决方案
请通知您的管理员继续使用需要 API 密钥。了解更多,或
访问 www.tiny.cloud/auth/signup 注册 API 密钥,以及
更新您的 TinyMCE 配置。
访问我们的 无效 API 密钥 页面,了解有关如何使用 TinyMCE 修复 无效 API 密钥 的更多信息。只读模式 - 无效的 API 密钥
“TinyMCE 处于只读模式。请通知管理员提供有效的 API 密钥以继续使用。了解更多 您的 TinyMCE 编辑器状态已设置为只读模式。”
原因“无效的 API 密钥(只读模式)”
当 API 密钥不正确时(例如由于拼写错误),将显示此消息。
解决方案
登录您的 TinyMCE 账户,并通过访问 www.tiny.cloud/auth/login/ 确认您的 API 密钥是否与您的唯一密钥匹配。
或者,若要注册 API 密钥,请访问:Tiny Cloud。
只读模式 - 无效来源
“TinyMCE 处于只读模式。请要求管理员将此域名添加到客户门户中的已批准域名列表。更多信息请参阅“域名未注册””
原因“无效来源(只读模式)”
当 TinyMCE 从尚未添加到我们账户门户中已批准域名的域名加载时,将显示此消息。
解决方案
请要求您的管理员将此域名添加到客户门户中的已批准域名列表。更多信息请参阅“域名未注册”
从 TinyMCE 7.6.0 开始,编辑器使用禁用模式而不是只读模式。