AMP 验证错误

有效的 AMP 文档不得包含任何验证错误。本文档旨在帮助您更好地理解并修复在验证 AMP 页面时遇到的任何验证错误。有关验证错误的完整概述，请参阅 AMP 验证器规范。

AMP HTML 标签和属性错误

缺少必需标签

代码	MANDATORY_TAG_MISSING
格式	"缺少或不正确的必需标签 '%1'。"
修复	添加（或更正）必需的 HTML 标签。

以下标签必须存在于所有 AMP 电子邮件中

<!doctype html>
<html amp4email> 或 <html ⚡4email>
<head>
<meta charset="utf-8">
<style amp4email-boilerplate>body{visibility:hidden}</style>
<script async src="https://cdn.ampproject.org/v0.js"></script>
<body>

这些必需标签在AMP 验证器规范中包含一个 mandatory: true 字段；它们也在AMP 规范中被引用。

缺少另一标签所必需的标签

代码	TAG_REQUIRED_BY_MISSING
格式	"缺少或不正确的标签 '%1'，但 '%2' 需要它。"
修复	添加（或更正）必需的 HTML 标签。

当验证器在 AMP 文档中找到扩展组件，但未找到其等效的 <script> 时，它会抛出 TAG_REQUIRED_BY_MISSING 错误。

扩展组件必须作为自定义元素显式包含在 AMP 文档中。要修复这些错误，请导航到扩展组件的参考页面，复制其所需的脚本，并将其粘贴到 AMP 文档的 <head> 中。

不允许的标签

代码	DISALLOWED_TAG
格式	"不允许的标签 '%1'。"
修复	删除不允许的标签。

标签是允许列表，因此没有所有不允许的标签的明确列表；但是，AMP 规范广泛定义了一组不允许的标签。

不允许自定义 JavaScript

代码	DISALLOWED_SCRIPT_TAG
格式	"不允许自定义 JavaScript。"
修复	删除 JavaScript 标签或使用 amp-script。

AMP 格式不允许通过 <script> 元素将自定义 JavaScript 添加到页面。JavaScript 的许多常见用法都有 AMP HTML 库的等效实现。有关可用于增强 AMP HTML 页面的组件集，请参阅AMP 组件。

如果没有任何可用组件涵盖您的用例，可以使用 amp-script 来运行您的自定义 JavaScript。

缺少必需属性

代码	MANDATORY_ATTR_MISSING
格式	"标签 '%2' 中缺少必需属性 '%1'。"
修复	将必需的属性添加到标签。

AMP 标签的必需属性在AMP 的验证器规范中定义。只需搜索标签，查看列出的属性，并检查 mandatory: true。每个 AMP 标签的必需属性也列在该标签的规范中。

属性值无效

代码	INVALID_ATTR_VALUE
格式	"标签 '%2' 中的属性 '%1' 设置为无效值 '%3'。"
修复	将属性值修复为有效的值。

此错误表示 HTML 标签具有允许名称的属性，但没有允许的值。例如，此错误的一个常见触发原因是 URL 的无效值。所有 URL 值（在 href 和 src 属性中）都必须与这些可能的属性值之一匹配。

重要提示： AMP 中的许多 URL 值都需要 HTTPS。如果您收到此错误，并且不确定原因，请检查相关的 AMP 标签的规范，以查看该属性是否需要 HTTPS。

不允许的属性

代码	DISALLOWED_ATTR
格式	"标签 '%2' 中可能不会出现属性 '%1'。"
修复	从 HTML 标签中删除该属性。

属性是允许列表，因此没有所有不允许的属性的明确列表。要检查每个特定标签支持的属性，请搜索 HTML 标签，然后在AMP 验证器规范中搜索 attrs。

除了每个标签的特定属性的允许列表外，所有 AMP 标签都可以使用 $GLOBAL_ATTRS 下允许列表中的任何属性；所有具有 "data-" 前缀的属性也在允许列表中。

缺少或不正确的必需文本

代码	MANDATORY_CDATA_MISSING_OR_INCORRECT
格式	"标签 '%1' 内的必需文本 (CDATA) 缺失或不正确。"
修复	添加或更正标签内的必需文本。

CDATA 是开始和结束 HTML 标签之间的内容数据，目前使用允许列表和拒绝列表进行评估。具有强制 CDATA 的标签包括

<style amp-boilerplate>body{-webkit-animation:-amp-start 8s steps(1,end) 0s 1 normal both;-moz-animation:-amp-start 8s steps(1,end) 0s 1 normal both;-ms-animation:-amp-start 8s steps(1,end) 0s 1 normal both;animation:-amp-start 8s steps(1,end) 0s 1 normal both}@-webkit-keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}@-moz-keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}@-ms-keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}@-o-keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}@keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}</style><noscript><style amp-boilerplate>body{-webkit-animation:none;-moz-animation:none;-ms-animation:none;animation:none}</style></noscript>

以及

<style amp-custom>

此错误的详细消息可以是以下之一

"必需的样式样板 (已启用 js)"
"必需的样式样板 (noscript)"
"不允许的 -amp- CSS 类名称前缀"
"CSS 中不允许的 !important 属性"
"CSS 中不允许的 @charset"
"CSS 中不允许的 @import"
"CSS 中不允许的 @namespace"
"CSS 中不允许的 @supports"
"CSS 中不允许的 @document"

"CSS 中不允许的 @page"

标签内不允许的文本

代码	CDATA_VIOLATES_DENYLIST
格式	"标签 '%1' 内的文本 (CDATA) 与 '%2' 匹配，这是不允许的。"
修复	删除不允许的文本。

为了验证基本的 CSS AMP 规则，某些 CSS 数据已被拒绝列出。

以下是拒绝列出的 CSS 数据列表（另请参阅AMP 验证器规范中的 disallowed_cdata_regex）

"\\.i?-amp-" ("CSS -amp- 类名称前缀")
"!important"
"charset"
"@import"
"@namespace"
"@document"

"@page"

无效的属性值

代码	INVALID_PROPERTY_VALUE_IN_ATTR_VALUE
格式	"标签 '%3' 中属性 '%2' 中的属性 '%1' 设置为 '%4'，这是无效的。"
修复	更正无效的属性值。

当属性内的属性值无效时，会发生此错误。此处的属性是指属性内的结构化键/值数据。

缺少 URL

代码	MISSING_URL
格式	"标签 '%2' 中属性 '%1' 的 URL 缺失。"
修复	添加有效的 URL。

当缺少需要 URL 的属性时，会发生此错误，例如，空的 href 或 src 属性。

无效 URL

代码	INVALID_URL_PROTOCOL
格式	"标签 '%2' 中属性 '%1' 的 URL '%3' 格式不正确"
修复	修复损坏的 URL。

当属性具有 URL，但该 URL 无效时，会发生此错误。

无效 URL 协议

代码	INVALID_URL_PROTOCOL
格式	标签 '%2' 中属性 '%1' 的无效 URL 协议 '%3:'。
修复	更改为有效的协议，例如，`http` 可能需要更改为 `https`。

当标签的 href 或 src 必须设置为特定协议时，会发生此错误。例如，许多标签需要 https。

互斥的属性

代码	MUTUALLY_EXCLUSIVE_ATTRS
格式	“标签 '%1' 中遇到了互斥的属性 - 请选择 %2 中的一个。”
修复	删除其中一个互斥的属性。

当标签同时具有互斥的属性时，会发生此错误。例如，以下标签只允许使用其中一个属性

amp-iframe：src 或 srcdoc
amp-jwplayer：data-media-id 或 data-playlist-id

缺少列表中必需的属性

代码	MANDATORY_ONEOF_ATTR_MISSING
格式	“标签 '%1' 缺少一个强制属性 - 请选择 %2 中的一个。”
修复	从提供的属性选择中添加缺少的强制属性。

当一个标签缺少多个可选属性中的一个必需属性时，会发生此错误。例如，这些标签需要从两个可能的选择中选择一个属性

amp-twitter：data-tweetid 或 src
amp-instagram：data-shortcode 或 src
amp-iframe：src 或 srcdoc
amp-youtube：src 或 data-videoid

错误的父标签

代码	WRONG_PARENT_TAG
格式	“标签 '%1' 的父标签为 '%2'，但它只能是 '%3'。”
修复	使该标签成为所需父标签的直接子标签。

特定的标签需要一个直接父标签（而不是远祖标签）。以下列出了特定标签所需的父标签（标签，父标签）

!doctype 需要父标签 root。
html 需要父标签 !doctype。
head 需要父标签 html。
body 需要父标签 html。
link 需要父标签 head。
meta 需要父标签 head。
style amp-custom 需要父标签 head。
style 需要父标签 boilerplate (noscript)。
noscript 需要父标签 head。
script 需要父标签 head。
source 需要一个媒体标签（amp-audio，amp-video 等）。

不允许的标签祖先

代码	DISALLOWED_TAG_ANCESTOR
格式	“标签 '%1' 不能作为标签 '%2' 的后代出现。”
修复	删除（或移动）不允许的嵌套标签。

当标签是另一个不验证的标签的后代时，会发生此错误。目前，唯一的例子是 template 标签，它不能嵌套在另一个 template 标签下。

必需的标签祖先

代码	MANDATORY_TAG_ANCESTOR
格式	“标签 '%1' 只能作为标签 '%2' 的后代出现。”
修复	删除标签或使其成为特定标签的后代。

强制后代在 AMP 验证器规范中定义为 mandatory_ancestor。

当以下标签缺少其 mandatory_ancestor 时，会发生错误（标签，祖先）

img 必须是 noscript 的后代。
video 必须是 noscript 的后代。
audio 必须是 noscript 的后代。
noscript 必须是 body 的后代。

重复的唯一标签

代码	DUPLICATE_UNIQUE_TAG
格式	“标签 '%1' 在文档中多次出现。”
修复	从 AMP 文档中删除重复标签之一。

当只允许存在一个标签实例，却发现重复时，会发生此错误。

已知唯一标签的完整列表

<!doctype html>
<html amp>
<head>
<link rel=canonical href=...>
<link rel=amphtml href=...>

<meta charset="utf-8"> * <style amp-custom> * <style amp-boilerplate>body{-webkit-animation:-amp-start 8s steps(1,end) 0s 1 normal both;-moz-animation:-amp-start 8s steps(1,end) 0s 1 normal both;-ms-animation:-amp-start 8s steps(1,end) 0s 1 normal both;animation:-amp-start 8s steps(1,end) 0s 1 normal both}@-webkit-keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}@-moz-keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}@-ms-keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}@-o-keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}@keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}</style><noscript><style amp-boilerplate>body{-webkit-animation:none;-moz-animation:none;-ms-animation:none;animation:none}</style></noscript> * <body> * <script src="https://cdn.ampproject.org/v0.js">

样式和布局错误

在深入研究样式和布局错误之前，值得了解 AMP 中样式和布局的工作方式。由于 AMP 页面是 HTML 页面，因此样式与任何 HTML 页面非常相似。但是，有一些限制可确保页面快速加载，并且 AMP 验证器会强制执行这些限制。

布局在 AMP 页面中受到更多控制。页面上显示的任何标签都需要预定义的高度和宽度，从而显著减少渲染和滚动卡顿。这并不意味着您必须手动包含这些属性。对于某些布局类型，AMP 验证器不会抛出错误，因为会假定默认值。

每个 AMP 标签都有一个 supported_layouts 列表，如 AMP 验证器规范中所定义。验证器将对不支持的布局抛出错误，并且它将检查预定义布局的验证规则。

样式表太长

代码	STYLESHEET_TOO_LONG
格式	“标签 'style' 中指定的作者样式表太长 - 我们看到了 %1 个字节，而限制为 %2 个字节。”
修复	将样式表的大小减少到 75,000 字节以下。

当 AMP 验证器测量 <style amp-custom> 中的样式内容大小超过 75,000 字节的限制时，会抛出此错误。

CSS 语法错误

代码	CSS_SYNTAX
格式	“标签 '%1' 中的 CSS 语法错误 - %2。”
修复	修复 CSS 语法错误。

当您在指定的标签中存在 CSS 语法错误时，会发生此错误。如果您不确定导致错误的原因，请尝试通过在线 CSS 验证器（例如，csslint）运行 CSS。

特定规则中的 CSS 语法错误

代码	CSS_SYNTAX_INVALID_AT_RULE
格式	“标签 '%1' 中的 CSS 语法错误 - 发现了无效的 @ 规则 '%2'。”
修复	修复指定的 CSS 语法错误。

此错误指的是 CSS 中的 @-rules，其中 AMP 只允许少量规则。（另请参阅 AMP 规范）。例如，不允许使用 @import。验证错误会明确告诉您无效的规则，从而更容易修复该规则。

AMP 标签不支持隐含布局

代码	IMPLIED_LAYOUT_INVALID
格式	“标签 '%2' 不支持隐含布局 '%1'。”
修复	为标签提供有效的布局属性。

当您没有为 AMP 标签指定布局，并且不支持隐含布局（基于宽度、高度和尺寸）时，会发生此错误。请在 AMP 验证器规范中检查标签的 supported_layout 值。

实际布局行为由 layout 属性决定。有关布局如何工作的更多信息，请参阅如何控制布局和 AMP HTML 布局系统规范。

注意 – 如果您没有指定布局，并且没有包含 width 和 height 值，则布局默认为 CONTAINER。由于任何 AMP 标签都不支持 CONTAINER，因此验证器会抛出错误。请指定 CONTAINER 以外的布局，或者添加 width 和/或 height 值，错误就会消失。

隐含布局不允许的属性

代码	ATTR_DISALLOWED_BY_IMPLIED_LAYOUT
格式	“标签 '%2' 中的属性 '%1' 不允许使用隐含布局 '%3'。”
修复	从标签中删除不允许的属性，或者指定允许它的布局。

当您没有为 AMP 标签指定布局，并且隐含布局包含不允许的属性时，会发生此错误。布局类型的禁止属性在 AMP HTML 布局系统规范中描述。

AMP 标签不支持指定的布局

代码	SPECIFIED_LAYOUT_INVALID
格式	“标签 '%2' 不支持指定的布局 '%1'。”
修复	指定标签支持的布局。

当标签指定的布局不受支持时，会发生此错误。请在 AMP 验证器规范中检查标签的 supported_layout 值。

实际布局行为由 layout 属性决定。有关布局如何工作的更多信息，请参阅如何控制布局和 AMP HTML 布局系统规范。

指定布局不允许的属性

代码	ATTR_DISALLOWED_BY_SPECIFIED_LAYOUT
格式	“标签 '%2' 中的属性 '%1' 不允许使用隐含布局 '%3'。”
修复	从标签中删除不允许的属性，或者指定允许它的布局。

当您为 AMP 标签指定布局，并且该布局包含不允许的属性时，会发生此错误。布局类型的禁止属性在 AMP HTML 布局系统规范中描述。

布局必需的属性的无效值

代码	ATTR_VALUE_REQUIRED_BY_LAYOUT
格式	“标签 '%3' 中属性 '%2' 的值 '%1' 无效 - 对于布局 '%4'，请将属性 '%2' 设置为值 '%5'。”
修复	将属性设置为指定的值。

当属性值对于指定的布局无效时，会发生此错误。要了解是什么触发了此错误，您需要熟悉布局的不同行为。

假设您将布局设置为 fixed-height，并且为 height 和 width 都包含数值。fixed-height 布局采用 height 值。width 属性必须不存在，否则设置为 auto。验证器会抛出 ATTR_VALUE_REQUIRED_BY_LAYOUT。

宽度和高度的单位不一致

代码	INCONSISTENT_UNITS_FOR_WIDTH_AND_HEIGHT
格式	“标签 '%1' 中宽度和高度的单位不一致 - 宽度以 '%2' 指定，而高度以 '%3' 指定。”
修复	提供一致的单位宽度和高度。

除了 layout=fixed 之外，宽度和高度属性需要以相同的单位表示。当它们不一致时，会触发此错误。

例如，<amp-img src="" layout="responsive" width="42px" height="42rem"> 会导致此错误消息

“标签 'amp-img 中宽度和高度的单位不一致 - 宽度以 'px' 指定，而高度以 'rem' 指定。”

模板错误

AMP 页面不能包含模板语法，除非该语法位于专门设计为包含模板的 AMP 标签中，例如 amp-mustache。

在您的源文件中包含模板是可以的，只要这些文件的生成输出不包含模板即可（另请参阅使用 CSS 预处理器）。

属性包含模板语法

代码	TEMPLATE_IN_ATTR_NAME
格式	“标签 '%2' 中属性名称 '%1' 中存在 Mustache 模板语法。”
修复	从属性中删除 Mustache 模板语法。

当验证器在属性值中发现 Mustache 模板语法时，会发生此错误。

属性包含未转义的模板语法

代码	UNESCAPED_TEMPLATE_IN_ATTR_VALUE
格式	“标签 '%2' 中的属性 '%1' 设置为 '%3'，其中包含未转义的 Mustache 模板语法。”
修复	转义 Mustache 模板。

当验证器在属性值中发现未转义的 Mustache 模板语法时，会发生此错误。

属性包含模板部分

代码	TEMPLATE_PARTIAL_IN_ATTR_VALUE
格式	“标签 '%2' 中的属性 '%1' 设置为 '%3'，其中包含 Mustache 模板局部。”
修复	删除 Mustache 局部。

当验证器在属性值中发现 Mustache 局部时，会发生此错误。

弃用错误

已弃用的标签

代码	DEPRECATED_TAG
格式	尚未定义错误消息（没有已弃用的标签）。
修复	移除已弃用的标签。

当在 AMP 文档中发现以前有效的 AMP 标签时，会发生此警告。这只是一个警告；带有警告的 AMP 文档仍然有效。目前不存在已弃用的标签；该警告保留用于未来的弃用。

已弃用的属性

代码	DEPRECATED_ATTR
格式	"标签 '%2' 中的属性 '%1' 已弃用，请改用 '%3'。"
修复	作为最佳实践，请移除已弃用的属性。

当在 AMP 文档中发现以前有效的 AMP 属性时，会发生此警告。这只是一个警告；带有警告的 AMP 文档仍然有效。

通过在AMP 验证器规范中搜索 deprecation 来识别每个 AMP 标签的已弃用属性。