本頁面由 Cloud Translation API 翻譯而成。

規則運算式保護政策部署錯誤疑難排解

查看 Apigee Edge 說明文件。
前往 Apigee X說明文件。資訊

InvalidRegularExpression

錯誤訊息

透過 Edge UI 或 Edge Management API 部署 API Proxy 會失敗，並顯示以下錯誤訊息：

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.

錯誤螢幕截圖

規則運算式錯誤文字無效

原因

如果 RegularExpressionProtection 政策的 <Pattern> 元素中的規則運算式無效，則 API Proxy 部署作業就會失敗。

診斷

找出錯誤訊息中的 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.

檢查失敗的規則運算式保護政策 XML 中的所有 <Pattern> 元素。檢查是否有任何 <Pattern> 元素包含無效的規則運算式。如果任何 <Pattern> 元素包含無效的規則運算式，就會造成錯誤。

舉例來說，下列政策指定的 Pattern> 值是 foo){2}，系統會將此值視為無效的規則運算式：
```
<?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 Proxy 部署作業會失敗。

解析度

確認 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

錯誤訊息

透過 Edge UI 或 Edge Management API 部署 API Proxy 會失敗，並顯示以下錯誤訊息：

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 Proxy 部署作業就會失敗。

如要進一步瞭解命名空間、XPath 和前置字串，請參閱「XML 命名空間以及它們對 XPath 和 XSLT 的影響」。

診斷

找出發生錯誤的 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.
```

在失敗的規則運算式保護政策 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>

檢查 RegularExpressionProtection 政策中的 <Namespaces> 和 <Expression> 元素。如果錯誤訊息中指出的特定 <Expression> 使用的前置字串或值不是 RegularExpressionProtection 政策中宣告的命名空間的一部分，這就是導致錯誤的原因。
請注意，指定的 <XPath> 使用 RegularExpressionProtection 政策範例中的 notapigee 前置字串：
```
<Expression>/notapigee:foo/notapigee:bar</Expression>
```
但所有 <Namespace> 元素中都未定義前置字串 notapigee；因此，<XPath> 的編譯失敗導致部署失敗。

解析度

確保 <XPath> 元素下方 <Expression> 元素中使用的命名空間在 RegularExpressionProtection 政策中宣告。如要修正上述範例，您可以將 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

錯誤訊息

透過 Edge UI 或 Edge Management API 部署 API Proxy 會失敗，並顯示以下錯誤訊息：

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.

錯誤螢幕截圖

「無法轉換」錯誤文字

原因

如果規則運算式政策中的 <XPath> 運算式將 <Type> 元素定義為 nodeset，但運算式無法轉換為 nodeset，API Proxy 的部署作業就會失敗。

診斷

找出發生錯誤的 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.
```

在失敗的規則運算式保護政策 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>

檢查 <XPath> 元素下方 <Type> 元素中設定的值。如果 <Type> 元素是 nodeset，就會導致錯誤。

在這個範例中，XPath 運算式是 count()，不會傳回一或多個節點。因此，API Proxy 部署作業失敗。

解析度

如果 <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

錯誤訊息

透過 Edge UI 或 Edge Management API 部署 API Proxy 會失敗，並顯示以下錯誤訊息：

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 Proxy 部署作業就會失敗。

診斷

找出發生錯誤的 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.
```

在失敗的規則運算式保護政策 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>

檢查政策中 <JSONPath> 元素下方的 <Expression> 元素。如果與 JSONPath 語法不相符，就會造成錯誤。在上述範例中，缺少右方括號，這將使運算式無效。

由於 JSON 路徑運算式無效，因此 API Proxy 的部署失敗。

解析度

確認規則運算式保護政策中 <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

錯誤訊息

透過 Edge UI 或 Edge Management API 部署 API Proxy 會失敗，並顯示以下錯誤訊息：

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 Proxy 的部署作業就會失敗。

如錯誤訊息所示，RegularExpressionProtection 政策至少要有下列其中一個元素：<URIPath>、<QueryParam>、<Header>、<FormParam>、<XMLPayload> 或 <JSONPayload>。

診斷

找出發生錯誤的 RegularExpressionProtection 政策名稱。你可以在錯誤訊息中找到相關資訊。舉例來說，下列錯誤中的政策名稱為 Regular-Expression-Protection-1:
```
RegularExpressionProtection Regular-Expression-Protection-1: at least one of URIPath, QueryParam, Header, FormParam, XMLPayload, JSONPayload is mandatory.
```
檢查失敗的規則運算式保護政策 (如上方步驟 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 Proxy 部署作業會失敗。

解析度

請確認 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

錯誤訊息

透過 Edge UI 或 Edge Management API 部署 API Proxy 會失敗，並顯示以下錯誤訊息：

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 Proxy 部署作業就會失敗。

診斷

找出發生錯誤的 RegularExpressionProtection 政策名稱，以及不含 <Pattern> 元素的子元素。你可以在錯誤訊息中找到這兩項資訊。

舉例來說，在下列錯誤中，政策名稱為 Regular-Expression-Protection-1，子元素為 XPath:
```
RegularExpressionProtection Regular-Expression-Protection-1: No patterns to enforce in XPath.
```

檢查未通過的規則運算式保護政策，確認步驟 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 Proxy 的部署失敗。

解析度

確認 <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

錯誤訊息

透過 Edge UI 或 Edge Management API 部署 API Proxy 會失敗，並顯示以下錯誤訊息：

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，就會發生這個錯誤。

診斷

找出發生錯誤的 RegularExpressionProtection 政策，以及未對應至 URI 的前置字串名稱。你可以在錯誤訊息中找到這兩項資訊。

舉例來說，在下列錯誤中，政策名稱為 Regular Expression Protection-1，前置字串為 apigee：
```
RegularExpressionProtection Regular-Expression-Protection-1: Non-empty prefix apigee cannot be mapped to empty uri.
```

在失敗的規則運算式保護政策 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>

確認步驟 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

錯誤訊息

透過 Edge UI 或 Edge Management API 部署 API Proxy 會失敗，並顯示以下錯誤訊息：

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>

診斷

找出發生錯誤的 RegularExpressionProtection 政策和前置字串名稱。你可以在錯誤訊息中找到這兩項資訊。

舉例來說，在下列錯誤中，政策名稱為 Regular Expression Protection-1，前置字串為 apigee：
```
RegularExpressionProtection Regular-Expression-Protection-1: Duplicate prefix apigee.
```

舉例來說，下列政策在 <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>

判斷含有特定前置字元 (在步驟 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

錯誤訊息

透過 Edge UI 或 Edge Management API 部署 API Proxy 會失敗，並顯示以下錯誤訊息：

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 Proxy 部署作業就會失敗。

診斷

請從錯誤訊息中找出失敗的規則運算式保護政策。舉例來說，在下列錯誤中，政策名稱為 Regular-Expression-Protection-1：
```
RegularExpressionProtection Regular-Expression-Protection-1: Empty XPath expression.
```

在失敗的規則運算式保護政策 XML 中，檢查是否有 <XMLPayload> 元素包含 <XPath> 子元素未定義的 <Expression> 元素，或 <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 Proxy 部署失敗。

解析度

請確認 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

錯誤訊息

透過 Edge UI 或 Edge Management API 部署 API Proxy 會失敗，並顯示以下錯誤訊息：

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 Proxy 部署作業就會失敗。

診斷

請從錯誤訊息中找出失敗的規則運算式保護政策。舉例來說，在下列錯誤中，政策名稱為 Regular-Expression-Protection-1：
```
Error Saving Revision 1
RegularExpressionProtection Regular-Expression-Protection-1: Empty JSONPath expression.
```

在失敗的規則運算式保護政策 XML 中，檢查是否有 <JSONPayload> 元素包含 <JSONPath> 子元素未定義的 <Expression> 元素，或 <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 Proxy 部署失敗。

解析度

請確認 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>