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

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

您正在查看 Apigee Edge 說明文件。
前往 Apigee X 說明文件。info

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.

錯誤螢幕截圖範例

InvalidRegularExpression 錯誤文字

原因

如果 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> 元素包含無效的規則運算式，就會造成錯誤。

舉例來說，下列政策會指定 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 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 代理程式會無法部署。

如要進一步瞭解命名空間、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>
```
不過，前置字串 notapigee 並未在任何 <Namespace> 元素中定義，因此 <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.

錯誤螢幕截圖範例

CannotBeConvertedToNodeset 錯誤文字

原因

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

診斷

找出發生錯誤的 RegularExpressionProtection 政策，以及無法轉換為節點集的 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) 指定為 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 代理程式會部署失敗。

診斷

找出發生錯誤的 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 代理程式就會部署失敗。

診斷

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

驗證是否有特定前置字串的 <Namespace> 元素，並在步驟 2 中找到有效的 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>