正则表达式保护政策部署错误问题排查

您正在查看 Apigee 和 Apigee Hybrid 文档。
查看 Apigee Edge 文档。

InvalidRegularExpression

错误消息

通过 Apigee 界面或 API 部署 API 代理失败并显示以下错误消息：

Error Deploying Revision revision_number to environment
RegularExpressionProtection policy_name: Invalid Regular Expression com.apigee.steps.regexprotection.RegularExpressionProtectionBean$RegexPattern@f4ecb23, Context Revision:revision_number;APIProxy:RegexThreat;Organization:organization;Environment:environment.

错误消息示例

Error Deploying Revision 1 to test
RegularExpressionProtection Regular-Expression-Protection-1: Invalid Regular Expression com.apigee.steps.regexprotection.RegularExpressionProtectionBean$RegexPattern@f4ecb23, Context Revision:1;APIProxy:RegexThreat;Organization:myorg;Environment:test.

错误屏幕截图示例

InvalidRegularExpression 错误文本

原因

如果 RegularExpressionProtection 政策的 <Pattern> 元素中的正则表达式无效，则 API 代理的部署将失败。

诊断

  1. 从错误消息中找出 RegularExpressionProtection 政策的名称。例如，在以下错误中，RegularExpressionProtection 政策名称为 Regular-Expression-Protection-1:

    Error Deploying Revision 1 to test
RegularExpressionProtection Regular-Expression-Protection-1: Invalid Regular Expression com.apigee.steps.regexprotection.RegularExpressionProtectionBean$RegexPattern@f4ecb23, Context Revision:1;APIProxy:RegexThreat;Organization:myorg;Environment:test.

  2. 检查失败的正则表达式保护政策 XML 中的所有 <Pattern> 元素。检查是否有任何 <Pattern> 元素包含无效的正则表达式。如果任何 <Pattern> 元素包含无效的正则表达式，就会导致此错误。

    例如，以下政策指定 foo){2} 的 Pattern> 值，这会被视为无效的正则表达式：

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <RegularExpressionProtection async="false" continueOnError="false" enabled="true" name="Regular-Expression-Protection-1">
        <DisplayName>Regular Expression Protection-1</DisplayName>
        <Properties/>
        <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
        <URIPath>
            <Pattern>foo){2}</Pattern>
        </URIPath>
        <Source>request</Source>
    </RegularExpressionProtection>

    在上述示例中，<Pattern> 中指定的正则表达式缺少左括号。因此，它被视为无效的正则表达式。因此，API 代理部署将失败。

解决方法

确保 RegularExpressionProtection 政策中的每个 <Pattern> 元素均包含有效的正则表达式。您可以搜索不同的在线或离线正则表达式工具来调试正则表达式。要更正上面所示的正则表达式保护政策示例，请添加缺少的括号：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <RegularExpressionProtection async="false" continueOnError="false" enabled="true" name="Regular-Expression-Protection-1">
        <DisplayName>Regular Expression Protection-1</DisplayName>
        <Properties/>
        <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
        <URIPath>
            <Pattern>(foo){2}</Pattern>
        </URIPath>
        <Source>request</Source>
    </RegularExpressionProtection>

XPathCompilationFailed

错误消息

通过 Apigee 界面或 API 部署 API 代理失败并显示以下错误消息：

Error Deploying Revision revision_number to environment
RegularExpressionProtection policy_name: Failed to compile xpath xpath_expression. Context Revision:revision_number;APIProxy:RegexThreat;Organization:organization;Environment:environment.

错误消息示例

Error Deploying Revision 1 to test
RegularExpressionProtection Regular-Expression-Protection-1: Failed to compile xpath /notapigee:foo/notapigee:bar. Context Revision:1;APIProxy:RegexThreat;Organization:myorg;Environment:test.

错误屏幕截图示例

XPathCompilationFailed 错误文本

原因

如果 <XPath> 元素中使用的前缀或值不属于 RegularExpressionProtection 政策中任何声明的命名空间，则 API 代理的部署将失败。

如需详细了解命名空间、XPath 和前缀，请参阅 XML 命名空间及其如何影响 XPath 和 XSLT。

诊断

  1. 标识出错的 RegularExpressionProtection 政策的名称以及使用的 XPath 表达式。您可以在错误消息中找到这两项。

    例如，在以下错误中，政策名称为 Regular-Expression-Protection-1，XPath 表达式为 /notapigee:foo/notapigee:bar:

    Error Deploying Revision 1 to test
RegularExpressionProtection Regular-Expression-Protection-1: Failed to compile xpath /notapigee:foo/notapigee:bar. Context Revision:1;APIProxy:RegexThreat;Organization:myorg;Environment:test.

  2. 在失败的正则表达式保护政策 XML 中，验证 Expression 元素中设置的 XPath 是否与错误消息中标识的 XPath 相符（上文中的第 1 步）。

    例如，以下政策将 XPath 指定为与错误消息中的内容相匹配的 /notapigee:foo/notapigee:bar：

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<RegularExpressionProtection async="false" continueOnError="false" enabled="true" name="Regular-Expression-Protection-1">
    <DisplayName>Regular Expression Protection-1</DisplayName>
    <Properties/>
    <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
    <Source>request</Source>
     <XMLPayload>
         <Namespaces>
             <Namespace prefix="apigee">http://www.apigee.com</Namespace>
         </Namespaces>
         <XPath>
             <Expression>/notapigee:foo/notapigee:bar</Expression>
             <Type>nodeset</Type>
             <Pattern>pattern</Pattern>
             <Pattern>pattern2</Pattern>
         </XPath>
     </XMLPayload>
</RegularExpressionProtection>
  3. 检查 RegularExpressionProtection 政策中的 <Namespaces> 和 <Expression> 元素。如果错误消息中指出的特定 <Expression> 使用的前缀或值不属于 RegularExpressionProtection 政策中声明的命名空间，就会导致此错误。

    请注意，特定 <XPath> 在 RegularExpressionProtection 政策示例中使用前缀 notapigee：

    <Expression>/notapigee:foo/notapigee:bar</Expression>

    但是，前缀 notapigee 未在任何 <Namespace> 元素中定义；因此，<XPath> 编译失败，从而导致部署失败。

解决方法

确保在 RegularExpressionProtection 政策中声明 <XPath>元素下 <Expression> 元素中使用的所有命名空间。如需更正上述示例，您可以将 notapigee 前缀替换为 apigee（在命名空间中声明）：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<RegularExpressionProtection async="false" continueOnError="false" enabled="true" name="Regular-Expression-Protection-1">
    <DisplayName>Regular Expression Protection-1</DisplayName>
    <Properties/>
    <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
    <Source>request</Source>
     <XMLPayload>
         <Namespaces>
             <Namespace prefix="apigee">http://www.apigee.com</Namespace>
         </Namespaces>
         <XPath>
             <Expression>/apigee:foo/apigee:bar</Expression>
             <Type>nodeset</Type>
             <Pattern>pattern</Pattern>
             <Pattern>pattern2</Pattern>
         </XPath>
     </XMLPayload>
</RegularExpressionProtection>

CannotBeConvertedToNodeset

错误消息

通过 Apigee 界面或 API 部署 API 代理失败并显示以下错误消息：

Error Deploying Revision revision_number to environment
RegularExpressionProtection policy_name: Result of xpath xpath_expression cannot be converted to nodeset. Context Revision:revision_number;APIProxy:RegexThreat;Organization:organization;Environment:environment.

错误消息示例

Error Deploying Revision 1 to test
RegularExpressionProtection Regular-Expression-Protection-1: Result of xpath count(//apigee:foo) cannot be converted to nodeset. Context Revision:1;APIProxy:RegexThreat;Organization:myorg;Environment:test.

错误屏幕截图示例

CannotBeConvertedToNodeset 错误文本

原因

如果正则表达式政策具有 <XPath> 表达式，其中 <Type> 元素定义为 nodeset，但表达式无法转换为 nodeset，则 API 代理的部署将失败。

诊断

  1. 找出出错的 RegularExpressionProtection 政策，以及无法转换为 nodeset 的 XPath 表达式。您可以在错误消息中找到这两项。

    例如，在以下错误中，政策名称为 Regular-Expression-Protection-1，XPath 表达式为 count(//apigee:foo):

    Error Deploying Revision 1 to test
RegularExpressionProtection Regular-Expression-Protection-1: Result of xpath count(//apigee:foo) cannot be converted to nodeset. Context Revision:1;APIProxy:RegexThreat;Organization:myorg;Environment:test.

  2. 在失败的正则表达式保护政策 XML 中，验证 <XPath> 元素的 <Expression> 元素中设置的 XPath 是否与错误消息中标识的 XPath 相符（上文中的第 1 步）。

    例如，以下政策将 指定为 count(//apigee:foo)，后者与错误消息中的内容匹配：

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <RegularExpressionProtection async="false" continueOnError="false" enabled="true" name="Regular-Expression-Protection-1">
        <DisplayName>Regular Expression Protection-1</DisplayName>
        <Properties/>
        <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
        <Source>request</Source>
         <XMLPayload>
             <Namespaces>
                 <Namespace prefix="apigee">http://www.apigee.com</Namespace>
             </Namespaces>
             <XPath>
                 <Expression>count(//apigee:foo)</Expression>
                 <Type>nodeset</Type>
                 <Pattern>pattern</Pattern>
                 <Pattern>pattern2</Pattern>
             </XPath>
         </XMLPayload>
    </RegularExpressionProtection>

  3. 检查 <XPath> 元素下的 <Type> 元素中设置的值。如果 <Type> 元素为 nodeset，就会导致此错误。

    在此示例中，XPath 表达式为 count()，该表达式不会返回一个或多个节点。因此，API 代理部署将失败。

解决方法

如果 <Type> 元素设置为 nodeset，请确保 <XPath> 中设置的 <Expression> 元素为一个或多个节点。或者，根据您的用例将 <Type> 元素更改为较合适的值。

如需解决上述示例中的问题，您可以将 <Expression> 元素更改为其他可以返回节点的值：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<RegularExpressionProtection async="false" continueOnError="false" enabled="true" name="Regular-Expression-Protection-1">
    <DisplayName>Regular Expression Protection-1</DisplayName>
    <Properties/>
    <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
    <Source>request</Source>
     <XMLPayload>
         <Namespaces>
             <Namespace prefix="apigee">http://www.apigee.com</Namespace>
         </Namespaces>
         <XPath>
             <Expression>/apigee:foo/apigee:bar</Expression>
             <Type>nodeset</Type>
             <Pattern>pattern</Pattern>
             <Pattern>pattern2</Pattern>
         </XPath>
     </XMLPayload>
</RegularExpressionProtection>

JSONPathCompilationFailed

错误消息

通过 Apigee 界面或 API 部署 API 代理失败并显示以下错误消息：

Error Deploying Revision revision_number to environment
RegularExpressionProtection policy_name: Failed to compile jsonpath jsonpath_expression Context Revision:revision_number;APIProxy:RegexThreat;Organization:organization;Environment:environment.

错误消息示例

Error Deploying Revision 1 to test
RegularExpressionProtection Regular-Expression-Protection-1: Failed to compile jsonpath $.store.book[*.author. Context Revision:1;APIProxy:RegexThreat;Organization:myorg;Environment:test.

错误屏幕截图示例

JSONPathCompilationFailed 错误文本

原因

如果政策表达式保护政策的 <JSONPath> 元素下的 <Expression>元素设成为了无效的 JSONPath 表达式，则 API 代理的部署将失败。

诊断

  1. 找出出错的 RegularExpressionProtection 政策的名称以及使用的无效 JSONPath 表达式。您可以在错误消息中找到这两项。

    例如，在以下错误中，政策名称为 Regular-Expression-Protection-1，JSONPath 表达式为 $.store.book[*.author:

    Error Deploying Revision 1 to test
RegularExpressionProtection Regular-Expression-Protection-1: Failed to compile jsonpath $.store.book[*.author. Context Revision:1;APIProxy:RegexThreat;Organization:myorg;Environment:test.

  2. 在失败的正则表达式保护政策 XML 中，验证 Expression 元素中设置的 JSONPath 是否与错误消息中标识的 JSONPath 匹配（上文中的第 1 步）。

    例如，以下政策将 <JSONPath> 元素下的 Expression 元素指定为与错误消息中的内容匹配的 $.store.book[*.author：

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <RegularExpressionProtection async="false" continueOnError="false" enabled="true" name="Regular-Expression-Protection-1">
        <DisplayName>Regular Expression Protection-1</DisplayName>
        <Properties/>
        <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
        <Source>request</Source>
        <JSONPayload>
             <JSONPath>
                 <Expression>$.store.book[*.author</Expression>
                 <Pattern>REGEX PATTERN</Pattern>
                 <Pattern>REGEX PATTERN</Pattern>
             </JSONPath>
            </JSONPayload>
    </RegularExpressionProtection>

  3. 检查政策中 <JSONPath> 元素下的 <Expression> 元素。如果它与 JSONPath 语法不匹配，就会导致此错误。在上面的示例中，右方括号括缺失，这导致表达式无效。

    由于 JSON 路径表达式无效，因此 API 代理的部署将失败。

解决方法

请确保正则表达式保护政策中 <JSONPath> 元素内 <Expression> 元素的值是有效的 JSONPath 表达式。

如需更正上面所示的示例，您可以向 <Expression> 元素值添加缺少的右方括号：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<RegularExpressionProtection async="false" continueOnError="false" enabled="true" name="Regular-Expression-Protection-1">
    <DisplayName>Regular Expression Protection-1</DisplayName>
    <Properties/>
    <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
    <Source>request</Source>
    <JSONPayload>
         <JSONPath>
             <Expression>$.store.book[*].author</Expression>
             <Pattern>REGEX PATTERN</Pattern>
             <Pattern>REGEX PATTERN</Pattern>
         </JSONPath>
        </JSONPayload>
</RegularExpressionProtection>

NothingToEnforce

错误消息

通过 Apigee 界面或 API 部署 API 代理失败并显示以下错误消息：

Error Saving Revision revision_number
RegularExpressionProtection policy_name: at least one of URIPath, QueryParam, Header, FormParam, XMLPayload, JSONPayload is mandatory.

错误消息示例

Error Saving Revision 1
RegularExpressionProtection Regular-Expression-Protection-1: at least one of URIPath, QueryParam, Header, FormParam, XMLPayload, JSONPayload is mandatory.

错误屏幕截图示例

NothingToEnforce 错误文本

原因

如果 RegularExpressionProtection 政策没有以下任何元素：<URIPath>、<QueryParam>、<Header>、<FormParam>、<XMLPayload> 或 <JSONPayload>，API 代理的部署失败。

如错误消息中所示，RegularExpressionProtection 政策中必须至少包含以下元素之一：<URIPath>、<QueryParam>、<Header>、<FormParam>、<XMLPayload> 或 <JSONPayload>。

诊断

  1. 标识出错的 RegularExpressionProtection 政策的名称。您可以在错误消息中找到它。例如，在以下错误中，政策名称为 Regular-Expression-Protection-1:

    RegularExpressionProtection Regular-Expression-Protection-1: at least one of URIPath, QueryParam, Header, FormParam, XMLPayload, JSONPayload is mandatory.

  2. 检查失败的正则表达式保护政策（上述第 1 步中已标识）。如果政策没有以下元素之一：<URIPath>、<QueryParam>、<Header>、<FormParam>、<XMLPayload> 或 <JSONPayload>，则会导致错误。

    例如，以下正则表达式保护政策不含任何上述元素：

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <RegularExpressionProtection async="false" continueOnError="false" enabled="true" name="Regular-Expression-Protection-1">
        <DisplayName>Regular Expression Protection-1</DisplayName>
        <Properties/>
        <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
        <Source>request</Source>
    </RegularExpressionProtection>

    由于提取变量政策中未包含任何必需元素，因此 API 代理部署将失败。

解决方法

请确保 RegularExpressionProtection 政策具有以下必需的元素中至少一个：<URIPath>、<QueryParam>、<Header>、<FormParam>、<XMLPayload> 或 <JSONPayload>。例如：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<RegularExpressionProtection async="false" continueOnError="false" enabled="true" name="Regular-Expression-Protection-1">
    <DisplayName>Regular Expression Protection-1</DisplayName>
    <Properties/>
    <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
    <Source>request</Source>
    <JSONPayload>
        <JSONPath>
            <Expression>$.store.book[*].author</Expression>
            <Pattern>REGEX PATTERN</Pattern>
            <Pattern>REGEX PATTERN</Pattern>
        </JSONPath>
    </JSONPayload>
</RegularExpressionProtection>

NoPatternsToEnforce

错误消息

通过 Apigee 界面或 API 部署 API 代理失败并显示以下错误消息：

Error Saving Revision revision_number
RegularExpressionProtection policy_name: No patterns to enforce in payload_name.

错误消息示例

Error Saving Revision 1
RegularExpressionProtection Regular-Expression-Protection-1: No patterns to enforce in XPath.

错误屏幕截图示例

NoPatternsToEnforce 错误文本

原因

如果有任何顶级元素（<URIPath>、<QueryParam>、<Header>、<FormParam>、<XMLPayload> 或 <JSONPayload>）不含 RegularExpressionProtection 政策中定义的 <Pattern> 元素，则 API 代理的部署将失败。

诊断

  1. 标识出错的 RegularExpressionProtection 政策的名称以及不包含 <Pattern> 元素的子元素。您可以在错误消息中找到这两项。

    例如，在以下错误中，政策名称为 Regular-Expression-Protection-1，子元素为 XPath:

    RegularExpressionProtection Regular-Expression-Protection-1: No patterns to enforce in XPath.
  2. 检查失败的正则表达式保护政策，并验证第 1 步中标识的子元素没有 <Pattern> 元素。如果其中不存在 <Pattern> 元素，则会导致此错误。

    例如，以下政策在 <XPath> 内没有 <Pattern> 元素：

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <RegularExpressionProtection async="false" continueOnError="false" enabled="true" name="Regular-Expression-Protection-1">
      <DisplayName>Regular Expression Protection-1</DisplayName>
      <Properties/>
      <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
      <Source>request</Source>
      <XMLPayload>
        <Namespaces>
          <Namespace prefix="apigee">http://www.apigee.com</Namespace>
        </Namespaces>
        <XPath>
          <Expression>/apigee:Greeting/apigee:User</Expression>
          <Type>string</Type>
        </XPath>
      </XMLPayload>
    </RegularExpressionProtection>

    由于 <XPath> 元素不含 <Pattern> 元素，因此 API 代理的部署将失败。

解决方法

确保 <URIPath>、<QueryParam>、<Header>、<FormParam>、<XMLPayload> 或 <JSONPayload> 元素中都至少指定了一个 <Pattern>。如需了解如何正确指定元素，请参阅 RegularExpressionProtection 政策。

如需更正上面的示例，我们只需将 <Pattern> 元素添加到 <XMLPayload> 下的 <XPath> 元素中：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<RegularExpressionProtection async="false" continueOnError="false" enabled="true" name="Regular-Expression-Protection-1">
  <DisplayName>Regular Expression Protection-1</DisplayName>
  <Properties/>
  <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
  <Source>request</Source>
  <XMLPayload>
    <Namespaces>
      <Namespace prefix="apigee">http://www.apigee.com</Namespace>
    </Namespaces>
    <XPath>
      <Expression>/apigee:Greeting/apigee:User</Expression>
      <Type>string</Type>
      <Pattern>REGEX PATTERN</Pattern>
    </XPath>
  </XMLPayload>
</RegularExpressionProtection>

NONEmptyPrefixMappedToEmptyURI

错误消息

通过 Apigee 界面或 API 部署 API 代理失败并显示以下错误消息：

Error Saving Revision revision_number
RegularExpressionProtection policy_name: Non-empty prefix prefix_name cannot be mapped to empty uri.

错误消息示例

Error Saving Revision 1
RegularExpressionProtection Regular-Expression-Protection-1: Non-empty prefix apigee cannot be mapped to empty uri.

错误屏幕截图示例

NONEmptyPrefixMappedToEmptyURI 错误文本

原因

如果 RegularExpressionProtection 政策在 <XMLPayload> 元素下的 <Namespace> 元素中定义了前缀，但未定义 URI，就会出现此错误。

诊断

  1. 标识出错的 RegularExpressionProtection 政策以及未映射到 URI 的前缀的名称。您可以在错误消息中找到这两项。

    例如，在以下错误中，政策名称是 Regular Expression Protection-1，而前缀为 apigee：

    RegularExpressionProtection Regular-Expression-Protection-1: Non-empty prefix apigee cannot be mapped to empty uri.

  2. 在失败的正则表达式保护政策 XML 中，验证在 <XMLPayload> 元素下 <Namespace> 元素内设置的前缀名称是否与错误消息中标识的前缀名称相匹配（上文中的第 1 步）。

    例如，以下政策会在 <Namespace> 元素中指定一个名为 apigee 的前缀，该前缀与错误消息中的内容相匹配：

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <RegularExpressionProtection async="false" continueOnError="false" enabled="true" name="Regular-Expression-Protection-1">
      <DisplayName>Regular Expression Protection-1</DisplayName>
      <Properties/>
      <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
      <Source>request</Source>
      <XMLPayload>
        <Namespaces>
          <Namespace prefix="apigee"/>
          <Namespace prefix="gmail">http://mail.google.com</Namespace>
        </Namespaces>
        <XPath>
          <Expression>/apigee:Greeting/apigee:User</Expression>
          <Type>string</Type>
          <Pattern>REGEX PATTERN</Pattern>
        </XPath>
      </XMLPayload>
    </RegularExpressionProtection>

  3. 验证在第 2 步中确定了特定前缀的<Namespace>元素是否具有有效 URI。 如果缺少 URI，则会导致错误。

    在以上所示的正则表达式保护政策示例中，请注意没有与前缀为 apigee 的 <Namespace> 元素对应的 URI；因此，您会收到以下错误：

    Non-empty prefix apigee cannot be mapped to empty uri.

解决方法

确保定义有前缀的所有 <Namespace> 元素在提取变量政策中都具有对应的 URI。例如：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<RegularExpressionProtection async="false" continueOnError="false" enabled="true" name="Regular-Expression-Protection-1">
  <DisplayName>Regular Expression Protection-1</DisplayName>
  <Properties/>
  <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
  <Source>request</Source>
  <XMLPayload>
    <Namespaces>
      <Namespace prefix="apigee">http://www.apigee.com</Namespace>
      <Namespace prefix="gmail">http://mail.google.com</Namespace>
    </Namespaces>
    <XPath>
      <Expression>/apigee:Greeting/apigee:User</Expression>
      <Type>string</Type>
      <Pattern>REGEX PATTERN</Pattern>
    </XPath>
  </XMLPayload>
</RegularExpressionProtection>

DuplicatePrefix

错误消息

通过 Apigee 界面或 API 部署 API 代理失败并显示以下错误消息：

Error Saving Revision revision_number
RegularExpressionProtection policy_name: Duplicate prefix prefix_name.

错误消息示例

Error Saving Revision 1
RegularExpressionProtection Regular-Expression-Protection-1: Duplicate prefix apigee.

错误屏幕截图示例

DuplicatePrefix 错误文本

原因

如果 RegularExpressionProtection 政策在 <XMLPayload> 元素下 <Namespace> 元素中多次定义了同一前缀，就会出现此错误。

例如，出现此错误是因为前缀 apigee 定义了两次，如下所示：

<Namespace prefix="apigee">http://www.apigee.com</Namespace>
<Namespace prefix="apigee">http://www.apigee.com</Namespace>

诊断

  1. 标识出错的 RegularExpressionProtection 政策以及前缀的名称。您可以在错误消息中找到这两项。

    例如，在以下错误中，政策名称是 Regular Expression Protection-1，而前缀为 apigee：

    RegularExpressionProtection Regular-Expression-Protection-1: Duplicate prefix apigee.

  2. 在失败的正则表达式保护政策 XML 中，验证在 <XMLPayload> 元素下 <Namespace> 元素内设置的前缀名称是否与错误消息中标识的前缀名称相匹配（上文中的第 1 步）。

    例如，以下政策会在 <Namespace> 元素中指定一个名为 apigee 的前缀，该前缀与错误消息中的内容相匹配：

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <RegularExpressionProtection async="false" continueOnError="false" enabled="true" name="Regular-Expression-Protection-1">
      <DisplayName>Regular Expression Protection-1</DisplayName>
      <Properties/>
      <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
      <Source>request</Source>
      <XMLPayload>
        <Namespaces>
          <Namespace prefix="apigee">http://www.apigee.com</Namespace>
          <Namespace prefix="apigee">http://www.apigee.com</Namespace>
        </Namespaces>
        <XPath>
          <Expression>/apigee:Greeting/apigee:User</Expression>
          <Type>string</Type>
          <Pattern>REGEX PATTERN</Pattern>
        </XPath>
      </XMLPayload>
    </RegularExpressionProtection>

  3. 确定在第 2 步中确定了特定前缀的 <Namespace> 元素是否定义了多次。 如果定义多次，则会导致错误。

    在上面所示的正则表达式保护政策示例中，请注意前缀为 apigee 的 <Namespace> 元素已定义了两次；因此，您会收到以下错误：

    Duplicate prefix apigee.

解决方法

确保在 RegularExpressionProtection 政策的 <Namespace> 元素中，每个前缀只有一个定义。例如：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <RegularExpressionProtection async="false" continueOnError="false" enabled="true" name="Regular-Expression-Protection-1">
      <DisplayName>Regular Expression Protection-1</DisplayName>
      <Properties/>
      <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
      <Source>request</Source>
      <XMLPayload>
        <Namespaces>
          <Namespace prefix="apigee">http://www.apigee.com</Namespace>
        </Namespaces>
        <XPath>
          <Expression>/apigee:Greeting/apigee:User</Expression>
          <Type>string</Type>
          <Pattern>REGEX PATTERN</Pattern>
        </XPath>
      </XMLPayload>
    </RegularExpressionProtection>

EmptyXPathExpression

错误消息

通过 Apigee 界面或 API 部署 API 代理失败并显示以下错误消息：

Error Saving Revision revision_number
RegularExpressionProtection policy_name: Empty XPath expression.

错误消息示例

Error Saving Revision 1
RegularExpressionProtection Regular-Expression-Protection-1: Empty XPath expression.

错误屏幕截图示例

EmptyXPathExpression 错误文本

原因

如果 RegularExpressionProtection 政策未在 <XPath> 元素中设置 <Expression> 元素，则 API 代理的部署将失败。

诊断

  1. 从错误消息中找出失败的正则表达式保护政策。例如，在以下错误中，政策名称为 Regular-Expression-Protection-1：

    RegularExpressionProtection Regular-Expression-Protection-1: Empty XPath expression.

  2. 在失败的正则表达式政策 XML 中，确定是否存在 <XMLPayload> 元素中不包含其中定义了 <Expression> 元素的 <XPath> 子元素，或 <Expression> 元素未设置为任何值。如果是，就会导致错误。

    例如，以下是包含 <XMLPayload> 元素的正则表达式保护政策：

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<RegularExpressionProtection async="false" continueOnError="false" enabled="true" name="Regular-Expression-Protection-1">
  <DisplayName>Regular Expression Protection-1</DisplayName>
  <Properties/>
  <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
  <Source>request</Source>
  <XMLPayload>
    <Namespaces>
      <Namespace prefix="apigee">http://www.apigee.com</Namespace>
    </Namespaces>
    <XPath>
      <Expression></Expression>
      <Type>string</Type>
      <Pattern>REGEX PATTERN</Pattern>
    </XPath>
  </XMLPayload>
</RegularExpressionProtection>

    由于 <XPath> 元素中有一个空 <Expression> 元素，因此 API 代理的部署将失败。

解决方法

确保 RegularExpressionProtection 政策在 <XPath> 元素下定义了一个非空且有效的 <Expression> 元素。例如：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<RegularExpressionProtection async="false" continueOnError="false" enabled="true" name="Regular-Expression-Protection-1">
  <DisplayName>Regular Expression Protection-1</DisplayName>
  <Properties/>
  <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
  <Source>request</Source>
  <XMLPayload>
    <Namespaces>
      <Namespace prefix="apigee">http://www.apigee.com</Namespace>
    </Namespaces>
    <XPath>
      <Expression>/apigee:Greeting/apigee:User</Expression>
      <Type>string</Type>
      <Pattern>REGEX PATTERN</Pattern>
    </XPath>
  </XMLPayload>
</RegularExpressionProtection>

EmptyJSONPathExpression

错误消息

通过 Apigee 界面或 API 部署 API 代理失败并显示以下错误消息：

Error Saving Revision revision_number
RegularExpressionProtection policy_name: Empty JSONPath expression.

错误消息示例

Error Saving Revision 1
RegularExpressionProtection Regular-Expression-Protection-1: Empty JSONPath expression.

错误屏幕截图示例

EmptyJSONPathExpression 错误文本

原因

如果 RegularExpressionProtection 政策未在 <JSONPath> 元素中设置 <Expression> 元素，则 API 代理的部署将失败。

诊断

  1. 从错误消息中找出失败的正则表达式保护政策。例如，在以下错误中，政策名称为 Regular-Expression-Protection-1：

    Error Saving Revision 1
RegularExpressionProtection Regular-Expression-Protection-1: Empty JSONPath expression.

  2. 在失败的正则表达式政策 XML 中，确定是否存在 <JSONPayload> 元素中不包含其中定义了 <Expression> 元素的 <JSONPath> 子元素，或 <Expression> 元素未设置为任何值。如果是，就会导致错误。

    例如，以下是包含 <JSONPayload> 元素的正则表达式保护政策：

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <RegularExpressionProtection async="false" continueOnError="false" enabled="true" name="Regular-Expression-Protection-1">
      <DisplayName>Regular Expression Protection-1</DisplayName>
      <Properties/>
      <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
      <Source>request</Source>
      <JSONPayload>
        <JSONPath>
          <Expression></Expression>
          <Pattern>REGEX PATTERN</Pattern>
          <Pattern>REGEX PATTERN</Pattern>
        </JSONPath>
      </JSONPayload>
    </RegularExpressionProtection>

    由于 <JSONPath> 元素中有一个空 <Expression> 元素，因此 API 代理的部署将失败。

解决方法

确保 RegularExpressionProtection 政策在 <JSONPath> 元素下定义了一个非空且有效的 <Expression> 元素。例如：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<RegularExpressionProtection async="false" continueOnError="false" enabled="true" name="Regular-Expression-Protection-1">
  <DisplayName>Regular Expression Protection-1</DisplayName>
  <Properties/>
  <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
  <Source>request</Source>
  <JSONPayload>
    <JSONPath>
      <Expression>$.store.book[*].author</Expression>
      <Pattern>REGEX PATTERN</Pattern>
      <Pattern>REGEX PATTERN</Pattern>
    </JSONPath>
  </JSONPayload>
</RegularExpressionProtection>