Khắc phục sự cố thời gian chạy của chính sách Xác thực thông báo SOAP

Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến tài liệu về Apigee X. thông tin

SourceMessageNotAvailable

Mã lỗi

steps.messagevalidation.SourceMessageNotAvailable

Nội dung phản hồi lỗi

{
  "fault": {
    "faultstring": "source_var_name message is not
     available for[policy_name]",
    "detail": {
      "Errorcode":
       "steps.messagevalidation.SourceMessageNotAvailable"
     }
  }
}

Ví dụ về nội dung phản hồi lỗi

{
  "fault": {
    "faultstring": "request message is not available for MessageValidation: SOAP-Message-Validation-1",
    "detail": {
      "errorcode": "steps.messagevalidation.SourceMessageNotAvailable"
    }
  }
}

Nguyên nhân

Lỗi này xảy ra nếu biến message được chỉ định trong phần tử <Source> của chính sách SOAPMessageValidation:

  • Ngoài phạm vi (không có trong luồng cụ thể mà chính sách đang được thực thi) hoặc
  • không thể giải quyết (không xác định)

Ví dụ: lỗi này xảy ra nếu phần tử <Source> trong chính sách SOAPMessageValidation được đặt thành một biến không tồn tại trong quy trình thực thi chính sách này.

Chẩn đoán

  1. Xác định tên chính sách SOAPMessageValidation nơi xảy ra lỗi và tên của biến source từ chuỗi lỗi. Ví dụ: trong chuỗi lỗi sau, tên chính sách SOAPMessageValidation là SOAP-Message-Validation-1 và biến source là request:

    "faultstring": "request message is not available for MessageValidation: SOAP-Message-Validation-1"

  2. Trong tệp XML của chính sách SOAPMessageValidation (Xác thực SOAPMessageValidation) bị lỗi, hãy xác minh rằng tên của biến được đặt trong phần tử <Source> khớp với tên biến được xác định trong chuỗi lỗi (Bước 1 ở trên).

    Ví dụ: chính sách SOAPMessageValidation sau đây chỉ định một biến có tên request trong phần tử <Source> khớp với nội dung trong chuỗi lỗi:

    <MessageValidation async="false" continueOnError="false" enabled="true" name="SOAP-Message-Validation-1">
    <DisplayName>SOAP Message Validation-1</DisplayName>
    <Properties/>
    <Element namespace="http://schemas.xmlsoap.org/soap/prices">GetPriceResponse</Element>
    <SOAPMessage/>
    <Source>request</Source>
    <ResourceURL>xsd://Script-1.xsd</ResourceURL>
</MessageValidation>

  3. Xác định xem biến được dùng trong phần tử <Source> đã được xác định và có sẵn trong quy trình thực thi chính sách SOAPMessageValidation hay không.

    Nếu biến là:

    • nằm ngoài phạm vi (không có trong luồng cụ thể mà chính sách đang được thực thi) hoặc
    • không thể phân giải (chưa được xác định)

    thì đó là nguyên nhân gây ra lỗi.

    Ví dụ: giả sử chính sách SOAPMessageValidation được trình bày ở trên thực thi trong quy trình phản hồi. Tuy nhiên, biến request được dùng trong ví dụ về phần tử <Source> ở trên chỉ có trong quy trình yêu cầu.

    Do biến request không tồn tại trong quy trình phản hồi nên bạn gặp lỗi sau:

    "faultstring": "request message is not available for MessageValidation: SOAP-Message-Validation-1"

Độ phân giải

Đảm bảo rằng biến được đặt trong phần tử <Source> của chính sách SOAPMessageValidation không thành công được xác định và tồn tại trong luồng mà chính sách thực thi.

Để sửa ví dụ hiển thị ở trên, bạn có thể sửa đổi <Source> phần tử để sử dụng biến response tồn tại trong luồng phản hồi:

<MessageValidation async="false" continueOnError="false" enabled="true" name="SOAP-Message-Validation-1">
    <DisplayName>SOAP Message Validation-1</DisplayName>
    <Properties/>
    <Element namespace="http://schemas.xmlsoap.org/soap/prices">GetPriceResponse</Element>
    <SOAPMessage/>
    <Source>response</Source>
    <ResourceURL>xsd://Script-1.xsd</ResourceURL>
</MessageValidation>

NonMessageVariable

Mã lỗi

steps.messagevalidation.NonMessageVariable

Nội dung phản hồi lỗi

{
  "fault": {
    "faultstring": "Variable var_name does not resolve to a Message"
    "detail": {
      "errorcode": "steps.messagevalidation.NonMessageVariable"
    }
  }
}

Ví dụ về nội dung phản hồi lỗi

{
  "fault": {
    "faultstring": "Variable message.content does not resolve to a Message",
    "detail": {
      "errorcode": "steps.messagevalidation.NonMessageVariable"
    }
  }
}

Nguyên nhân

Lỗi này xảy ra nếu phần tử <Source> trong chính sách SOAPMessageValidation được đặt thành một biến không thuộc loại Message.

Biến loại thông báo đại diện cho toàn bộ yêu cầu và phản hồi HTTP. Các biến flow tích hợp sẵn trong Apigee Edge request, response và message đều thuộc loại Thông báo. Để tìm hiểu thêm về các biến thông báo, hãy xem bài viết Tài liệu tham khảo về biến.

Chẩn đoán

  1. Xác định tên của biến không phân giải thành Loại Thông báo từ chuỗi lỗi. Ví dụ: trong chuỗi lỗi sau, tên của biến là message.content:

    "faultstring": "Variable message.content does not resolve to a Message"

  2. Kiểm tra tất cả chính sách SOAPMessageValidation trong Proxy API cụ thể nơi xảy ra lỗi. Có thể có một hoặc nhiều chính sách SOAPMessageValidation. Xác định chính sách hoặc các chính sách SOAPMessageValidation cụ thể, trong đó biến được chỉ định trong phần tử <Source> khớp với tên biến được xác định trong chuỗi lỗi (Bước 1 ở trên).

    Ví dụ: chính sách sau đây đặt phần tử <Source> thành biến có tên message.content, khớp với nội dung trong chuỗi lỗi:

    <MessageValidation async="false" continueOnError="false" enabled="true" name="SOAP-Message-Validation-1">
    <DisplayName>SOAP Message Validation-1</DisplayName>
    <Properties/>
    <Element namespace="http://schemas.xmlsoap.org/soap/prices">GetPriceResponse</Element>
    <SOAPMessage/>
    <Source>message.content</Source>
    <ResourceURL>xsd://Script-1.xsd</ResourceURL>
</MessageValidation>

    Vì biến message.content không thuộc loại Thông báo nên bạn gặp lỗi:

    "faultstring": "Variable message.content does not resolve to a Message"

Độ phân giải

Đảm bảo rằng phần tử <Source> trong chính sách SOAPMessageValidation (Tin nhắn) không thành công được đặt thành biến loại Message (Tin nhắn) tồn tại trong quy trình thực thi chính sách này.

Để sửa chính sách, bạn có thể sửa đổi phần tử <Source> để chỉ định một biến thuộc loại Message (Thông báo). Ví dụ: trong chính sách SOAPMessageValidation không thành công, bạn có thể chỉ định phần tử <Source> là request:

<MessageValidation async="false" continueOnError="false" enabled="true" name="SOAP-Message-Validation-1">
    <DisplayName>SOAP Message Validation-1</DisplayName>
    <Properties/>
    <Element namespace="http://sample.com"> sampleObject</Element>
    <SOAPMessage/>
    <Source>request</Source>
    <ResourceURL>xsd://Script-1.xsd</ResourceURL>
</MessageValidation>

Không thành công

Mã lỗi

steps.messagevalidation.Failed

Nội dung phản hồi lỗi

{
  "fault": {
    "faultstring": "Variable var_name failed with reason: \"reason [Line varline_num
    "detail": {
      "errorcode": "steps.messagevalidation.Failed"
    }
  }
}

Ví dụ về nội dung phản hồi lỗi

{
  "fault": {
    "faultstring": "SOAP-Message-Validation-1 failed with reason: \"Expecting a child element but found none [Line 9]\"",
    "detail": {
      "errorcode": "steps.messagevalidation.Failed"
    }
  }
}

Nguyên nhân

Lỗi này xảy ra nếu chính sách SOAPMessageValidation (Xác thực SOAPMessageValidation) không xác thực được tải trọng thông báo đầu vào dựa trên giản đồ XSD hoặc định nghĩa WSDL. Lỗi này cũng sẽ xảy ra nếu có JSON hoặc XML không đúng định dạng trong thông báo tải trọng.

Dưới đây là một số nguyên nhân có thể dẫn đến lỗi này:

Nguyên nhân Mô tả
Trọng tải XML không khớp Tải trọng XML đầu vào không tuân thủ giản đồ XSD được chỉ định trong chính sách SoapMessageValidation.
Tải trọng SOAP không khớp Trọng tải SOAP đầu vào không tuân thủ định nghĩa WSDL được chỉ định trong chính sách SoapMessageValidation.
XML hoặc XML không đúng định dạng Gói dữ liệu SOAP đầu vào không chứa XML hoặc JSON được định dạng đúng cách.

Nguyên nhân: Trọng tải XML không khớp

Lỗi này xảy ra nếu tải trọng XML đầu vào không tuân thủ giản đồ XSD được chỉ định trong phần tử <ResourceURL> của chính sách SoapMessageValidation.

Thông báo lỗi mẫu

{
  "fault": {
    "faultstring": "SOAP-Message-Validation-1 failed with reason: \"Expecting a child element but found none [Line 9]\"",
    "detail": {
      "errorcode": "steps.messagevalidation.Failed"
    }
  }
}

Chẩn đoán

  1. Xác định tên chính sách SOAPMessageValidation, lý do xảy ra lỗi và số dòng mà tải trọng XML không khớp với giản đồ XSD. Tất cả thông tin này đều nằm trong chuỗi lỗi. Ví dụ: trong chuỗi lỗi sau, tên chính sách SOAPMessageValidation là SOAP-Message-Validation-1, lý do lỗi là Expecting a child element but found none [Line 9]: và số dòng là 9.

    "faultstring": "SOAP-Message-Validation-1 failed with reason: \"Expecting a child element but found none [Line 9]\""

  2. Kiểm tra chính sách SOAPMessageValidation và xác nhận rằng chính sách này sử dụng tệp định nghĩa giản đồ XSD để xác thực thông báo. Ví dụ: chính sách SOAPMessageValidation sau đây có một tệp tài nguyên XSD trong phần tử <ResourceURL>:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<MessageValidation async="false" continueOnError="false" enabled="true" name="SOAP-Message-Validation-1">
    <DisplayName>SOAP Message Validation-1</DisplayName>
    <Properties/>
    <SOAPMessage/>
    <Source>request</Source>
    <ResourceURL>xsd://Script-1.xsd</ResourceURL>
</MessageValidation>

  3. Kiểm tra tải trọng đầu vào theo số dòng đã xác định trong Bước 1 ở trên để tìm hiểu nguyên nhân gây ra lỗi.

    Trọng tải XML đầu vào mẫu

    <?xml version="1.0"?>
<soap:Envelope
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" soap:encodingStyle="http://www.w3.org/2003/05/soap-encoding">
<soap:Body>
    <shipOrder
    xmlns:xsi="http://www.w3.org/2000/10/XMLSchema-instance">
    <shipTo>
        <name>Karl Kalckstein</name>
    </shipTo>
    <items>
        <item>
            <title>I love APIs</title>
            <quantity>1</quantity>
            <price>2.90</price>
        </item>
    </items>
</shipOrder>
</soap:Body>
</soap:Envelope>

    Trong ví dụ minh hoạ ở trên, dòng 9 có thẻ đóng </shipTo>.

  4. Hãy kiểm tra tệp định nghĩa lược đồ XML (Script-1.xsd) dùng trong chính sách SOAPMessageValidation (Xác thực SOAPMessageValidation) để xem giao diện của phần tử <shipTo>:

    ...
<xsd:element name="shipTo" type="shipAddress"/>
...
<xsd:complexType name="shipAddress">
<xsd:sequence>
<xsd:element name="name" type="xsd:string"/>
<xsd:element name="street" type="xsd:string"/>
<xsd:element name="address" type="xsd:string"/>
<xsd:element name="country" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
...

    Theo XSD mẫu dùng để xác thực, phần tử <shipTo> phải có các phần tử con <name>, <street>, <address> và <country>. Tuy nhiên, tải trọng XML đầu vào chỉ có một phần tử con là <name>. Kết quả là bạn sẽ gặp lỗi:

    "faultstring": "SOAP-Message-Validation-1 failed with reason: \"Expecting a child element but found none [Line 9]\""

Độ phân giải

Có hai cách để giải quyết lỗi xác thực này:

Giải pháp 1

Nếu xác định rằng định nghĩa giản đồ XSD áp đặt các giới hạn không cần thiết và chỉ yêu cầu phần tử con <name> trong phần tử <shipTo>, thì bạn có thể sửa đổi Script-1.xsd được dùng trong chính sách SOAPMessageValidation. Để xác thực ví dụ về tải trọng ở trên, bạn có thể sửa đổi tệp XSD như sau:

...
<xsd:element name="shipTo" type="shipAddress"/>
...
<xsd:complexType name="shipAddress">
<xsd:sequence>
<xsd:element name="name" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>

Giải pháp 2

Nếu tệp định nghĩa XSD là chính xác, thì bạn có thể thay đổi tải trọng XML đầu vào để khớp với xsd. Ví dụ: bạn có thể sửa đổi tải trọng để tuân thủ xsd như sau:

<?xml version="1.0">
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" soap:encodingStyle="http://www.w3.org/2003/05/soap-encoding">
<soap:Body>
    <shipOrder xmlns:xsi="http://www.w3.org/2000/10/XMLSchema-instance">
    <shipTo>
        <name>Karl Kalckstein</name>
        <street>1020 Parkway</street>
        <address>Mountain View, CA 94043</address>
        <country>USA</country>
    </shipTo>
    <items>
        <item>
            <title>I love APIs</title>
            <quantity>1</quantity>
            <price>2.90</price>
        </item>
    </items>
</shipOrder>
</soap:Body>
</soap:Envelope>

Nguyên nhân: tải trọng SOAP không khớp

Lỗi này xảy ra nếu tải trọng SOAP đầu vào không tuân thủ định nghĩa WSDL được chỉ định trong phần tử <ResourceURL> của chính sách SoapMessageValidation.

Ví dụ về thông báo lỗi

{
  "fault": {
    "faultstring": "SOAP-Message-Validation-1 failed with reason: \"Element name mismatch. Wildcard? [Line 11]\"",
    "detail": {
      "errorcode": "steps.messagevalidation.Failed"
    }
  }
}

Chẩn đoán

  1. Xác định tên chính sách SOAPMessageValidation, lý do không thực hiện được và số dòng mà phần tải dữ liệu SOAP không khớp với định nghĩa WSDL. Bạn có thể tìm thấy tất cả thông tin này trong chuỗi lỗi. Ví dụ: trong chuỗi lỗi sau, tên chính sách SOAPMessageValidation là SOAP-Message-Validation-1, nguyên nhân gây ra lỗi là \"Element name mismatch. Wildcard? [Line 11]\"" và số dòng là 11:

    "faultstring": "SOAP-Message-Validation-1 failed with reason: \"Element name mismatch. Wildcard? [Line 11]\""

  2. Kiểm tra chính sách SOAPMessageValidation và xác nhận rằng chính sách này sử dụng giản đồ wsdl để xác thực thông báo. Ví dụ: chính sách SOAPMessageValidation sau đây có một tệp tài nguyên wsdl trong phần tử <ResourceURL>:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<MessageValidation async="false" continueOnError="false" enabled="true" name="SOAP-Message-Validation-1">
    <DisplayName>SOAP Message Validation-1</DisplayName>
    <Properties/>
    <SOAPMessage/>
    <Source>request</Source>
 <ResourceURL>wsdl://SOAP-Message-Validation-1.wsdl</ResourceURL>
</MessageValidation>

  3. Kiểm tra tải trọng đầu vào theo số dòng đã xác định trong Bước 1 để tìm hiểu nguyên nhân gây ra lỗi.

    Trọng tải SOAP đầu vào mẫu

    <?xml version="1.0"?>
<soap:Envelope
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
soap:encodingStyle="http://www.w3.org/2003/05/soap-encoding">
<soap:Body>
<shipOrder
xmlns:xsi="http://www.w3.org/2000/10/XMLSchema-instance">
  <shipTo>
    <name>Karl Kalckstein</name>
    <street>1020 Parkway</street>
    <address>Mountain View, CA 94043</address>
    <country>USA</country>
  </shipTo>
  <items>
    <item>
      <title>I love APIs</title>
      <quantity>1</quantity>
      <price>2.90</price>
    </item>
  </items>

    Trong ví dụ minh hoạ ở trên, dòng 11 có phần tử con <country> trong phần tử <shipTo>.

  4. Kiểm tra tệp Định nghĩa WSDL, SOAP-Message-Validation-1.wsdl, được dùng trong chính sách SOAPMessageValidation để xem có gì không ổn với phần tử con <country> trong phần tử <shipTo>:

    <?xml version="1.0" encoding="ISO-8859-1"?>
<wsdl:definitions xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
    <wsdl:types>
      <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<xsd:element name="shipOrder" type="order"/>
<xsd:complexType name="order">
<xsd:sequence>
<xsd:element name="shipTo" type="shipAddress"/>
<xsd:element name="items" type="cdItems"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="shipAddress">
<xsd:sequence>
<xsd:element name="name" type="xsd:string"/>
<xsd:element name="street" type="xsd:string"/>
<xsd:element name="address" type="xsd:string"/>
</xsd:sequence>
...

    Theo định nghĩa WSDL dùng để xác thực, phần tử <shipTo> không có phần tử con <country>. Kết quả là bạn sẽ gặp lỗi:

    "faultstring": "SOAP-Message-Validation-1 failed with reason: \"Element name mismatch. Wildcard? [Line 11]\""

Độ phân giải

Có hai cách để giải quyết lỗi xác thực này:

Giải pháp 1

Nếu xác định rằng định nghĩa WSDL được sử dụng là không chính xác, bạn có thể thay đổi SOAP-Message-Validation-1.wsdl được sử dụng trong chính sách SOAPMessageValidation. Để xác thực ví dụ về tải trọng ở trên, bạn có thể sửa đổi tệp như sau:

...
<xsd:complexType name="shipAddress">`
...
<sequence>
    <element name="name" type="xsd:string"/>
    <element name="street" type="xsd:string"/>
    <element name="address" type="xsd:string"/>
    <element name="country" type="xsd:string"/>
</sequence>

Giải pháp 2

Nếu định nghĩa WSDL là chính xác, thì tải trọng SOAP đầu vào có thể được thay đổi để khớp với định nghĩa WSDL.

Ví dụ: Bạn có thể sửa đổi tải trọng SOAP đầu vào như sau:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<soap:Envelope
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
soap:encodingStyle="http://www.w3.org/2003/05/soap-encoding">
<soap:Body>
<shipOrder xmlns:xsi="http://www.w3.org/2000/10/XMLSchema-instance">
    <shipTo>
        <name>Karl Kalckstein</name>
        <street>1020 Parkway</street>
        <address>Mountain View, CA 94043</address>
    </shipTo>
    <items>
        <item>
            <title>I love APIs</title>
            <quantity>1</quantity>
            <price>2.90</price>
        </item>
    </items>

Nguyên nhân: JSON hoặc XML không đúng định dạng

Lỗi này xảy ra nếu tải trọng SOAP đầu vào không tuân thủ định nghĩa WSDL được chỉ định trong phần tử <ResourceURL> của chính sách SoapMessageValidation.

Thông báo lỗi mẫu

{
  "fault": {
    "faultstring": "SOAP-Message-Validation-1 failed with reason: \"Expected <\/title> at line 15(possibly  around char 420)\"",
    "detail": {
      "errorcode": "steps.messagevalidation.Failed"
    }
  }
}

Chẩn đoán

  1. Xác định tên chính sách SOAPMessageValidation, lý do không thành công và số dòng của tải trọng XML không khớp với định nghĩa WSDL. Bạn có thể tìm thấy tất cả thông tin này trong chuỗi về lỗi. Ví dụ: trong chuỗi lỗi sau, tên chính sách SOAPMessageValidation là SOAP-Message-Validation-1, nguyên nhân gây ra lỗi là Expected </title> at line 15(possibly around char 420): và số dòng là15.

    "faultstring": "SOAP-Message-Validation-1 failed with reason: \"Expected </title> at line 15(possibly  around char 420)\""

  2. Kiểm tra tải trọng đầu vào trên số dòng được xác định ở Bước 1 ở trên để tìm hiểu nguyên nhân gây ra lỗi.

    Tải trọng SOAP đầu vào mẫu

    <?xml version="1.0"?>
<soap:Envelope
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
soap:encodingStyle="http://www.w3.org/2003/05/soap-encoding">
<soap:Body>
<shipOrder xmlns:xsi="http://www.w3.org/2000/10/XMLSchema-instance">
  <shipTo>
    <name>Karl Kalckstein</name>
    <street>1020 Parkway</street>
    <address>Mountain View, CA 94043</address>
    <country>USA</country>
  </shipTo>
  <items>
    <item>
      <title>I love APIs</titles>
      <quantity>1</quantity>
      <price>2.90</price>
    </item>
  </items>
</shipOrder>
</soap:Body>
</soap:Envelope>

    Trong ví dụ ở trên, dòng 15 của tệp XML đầu vào có phần tử <title> nhưng không được đóng bằng thẻ kết thúc </title>.

Độ phân giải

Để khắc phục lỗi này, hãy đảm bảo rằng tải trọng đầu vào là hợp lệ và được định dạng đúng cách.

Ví dụ: bạn có thể sửa đổi tải trọng XML đầu vào như sau:

...
</shipTo>
<items>
  <item>
    <title>I love APIs</title>
    <quantity>1</quantity>
    <price>2.90</price>
  </item>
</items>
...