Khắc phục lỗi thời gian chạy Chú thích dịch vụ

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

RequestVariableNotMessageType

Mã lỗi

steps.servicecallout.RequestVariableNotMessageType

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

{
    "fault": {
        "faultstring": "ServiceCallout[policy_name]: request variable [variable_name] value is not of type Message",
        "detail": {
            "errorcode": "steps.servicecallout.RequestVariableNotMessageType"
        }
    }
}

Nguyên nhân

Lỗi này xảy ra nếu một biến được chỉ định trong phần tử <Request> của Chính sách chú thích dịch vụ không thuộc loại message. Nếu biến là một chuỗi hoặc bất kỳ loại nào khác không phải là thông báo, thì bạn sẽ thấy lỗi này.

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 luồng Edge tích hợp sẵn request, response và message thuộc loại thông báo. Để tìm hiểu thêm về biến thông báo, hãy xem phần Tài liệu tham khảo về biến.

Chẩn đoán

  1. Xác định chính sách Chú thích dịch vụ nơi xảy ra lỗi và tên của biến có kiểu không chính xác. Bạn có thể tìm thấy cả hai mục này trong phần tử faultstring của phản hồi lỗi. Ví dụ: trong faultstring sau đây, tên chính sách là ExecuteGeocodingRequest và biến là PostalCode:

    "faultstring": "ServiceCallout[ExecuteGeocodingRequest]: request variable PostalCode value is not of type Message"

  2. Trong tệp XML chính sách Lệnh gọi dịch vụ không thành công, hãy xác minh rằng tên của biến được đặt trong phần tử <Request> 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 chỉ định một biến yêu cầu có tên là PostalCode, khớp với nội dung trong faultstring:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ServiceCallout name="ExecuteGeocodingRequest">
    <Request variable="PostalCode"/>
    <Response>GeocodingResponse</Response>
    <HTTPTargetConnection>
        <URL>http://maps.googleapis.com/maps/api/geocode/json</URL>
    </HTTPTargetConnection>
</ServiceCallout>

  3. Xác định xem biến này có phải là loại thông báo hay không:

    1. Tìm mã trong gói Proxy API, nơi biến được xác định trước tiên.
    2. Trong hầu hết các trường hợp, bạn sẽ thấy biến vấn đề được tạo và điền sẵn trong một chính sách khác thực thi trước chính sách Chú thích dịch vụ. Ví dụ: Chính sách Chỉ định thông báo thường được dùng để tạo và điền các biến trong luồng proxy API.
    3. Sau khi tìm ra chính sách trong đó biến được xác định và điền sẵn trước tiên, bạn cần xác định loại biến đó như sau:
      • Kiểm tra giá trị của thuộc tính type (nếu có).
      • Nếu không có thuộc tính type thì biến được coi là một chuỗi.
    4. Nếu loại của biến không phải là thông báo (chẳng hạn như chuỗi), thì đó là nguyên nhân gây ra lỗi. Bạn có thể tìm hiểu về các biến phổ biến và loại biến trong phần Tài liệu tham khảo về biến.

Ví dụ: giả sử biến PostalCode được tham chiếu trong chính sách Chú thích dịch vụ được tạo trong chính sách Chỉ định thông báo sau đây. Lưu ý rằng PostalCode được gán giá trị của biến flow request.queryparam.postalcode. Giá trị này là một chuỗi, vì không có thuộc tính type nào trong quá trình chỉ định biến.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage name="GenerateGeocodingRequest">
        <AssignTo createNew="true" type="request">GeocodingRequest</AssignTo>
    <Set>
        <QueryParams>
            <QueryParam name="address">{request.queryparam.postalcode}</QueryParam>
            <QueryParam name="region">{request.queryparam.country}</QueryParam>
            <QueryParam name="sensor">false</QueryParam>
        </QueryParams>
        <Verb>GET</Verb>
    </Set>
    <AssignVariable>
        <Name>PostalCode</Name>
        <Ref>request.queryparam.postalcode</Ref>
    </AssignVariable>
    <AssignVariable>
        <Name>Country</Name>
        <Ref>request.queryparam.country</Ref>
    </AssignVariable>
</AssignMessage>

Bây giờ, hãy nhớ rằng biến PostalCode được sử dụng trong phần tử <Request> của chính sách về Chú thích dịch vụ:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ServiceCallout name="ExecuteGeocodingRequest">
    <Request variable="PostalCode"/>
    <Response>GeocodingResponse</Response>
    <HTTPTargetConnection>
        <URL>http://maps.googleapis.com/maps/api/geocode/json</URL>
    </HTTPTargetConnection>
</ServiceCallout>

Vì PostalCode không thuộc loại thông báo (trong ví dụ này là một chuỗi), nên bạn sẽ nhận được mã lỗi: steps.servicecallout.RequestVariableNotMessageType.

Độ phân giải

Đảm bảo rằng biến được đặt trong phần tử <Request> của chính sách Chú thích dịch vụ không thành công là biến luồng tin nhắn đã tồn tại, hoặc bạn có thể tạo biến loại thông báo mới ngay trong chính sách Chú thích dịch vụ (như giải thích trong tài liệu về chính sách) rồi sử dụng biến đó.

Để sửa chính sách, bạn phải sửa đổi phần tử <Request> để chỉ định một biến hiện có hoặc biến mới thuộc loại thông báo. Ví dụ: biến GeocodingRequest được đặt trong chính sách Gán thông báo thuộc loại thông báo và sẽ hoạt động tốt trong chính sách Chú thích dịch vụ. Ví dụ:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ServiceCallout name="ExecuteGeocodingRequest">
    <Request variable="GeocodingRequest"/>
    <Response>GeocodingResponse</Response>
    <HTTPTargetConnection>
        <URL>http://maps.googleapis.com/maps/api/geocode/json</URL>
    </HTTPTargetConnection>
</ServiceCallout>

RequestVariableNotRequestMessageType

Mã lỗi

steps.servicecallout.RequestVariableNotRequestMessageType

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

{
    "fault": {
        "faultstring": "ServiceCallout[policy_name]: request variable [variable_name] value is not of type Request Message",
        "detail": {
            "errorcode": "steps.servicecallout.RequestVariableNotRequestMessageType"
        }
    }
}

Nguyên nhân

Lỗi này xảy ra nếu một biến được chỉ định trong phần tử <Request> của Chính sách về chú thích dịch vụ không thuộc loại yêu cầu thông báo. Nếu biến là loại thông báo phản hồi, chuỗi hoặc bất kỳ loại nào khác, thì bạn sẽ thấy lỗi này.

Biến kiểu Message (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 luồng Edge tích hợp sẵn request, response và message 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 chính sách Chú thích dịch vụ nơi xảy ra lỗi và tên của biến có kiểu không chính xác. Bạn có thể tìm thấy cả hai mục này trong phần tử faultstring của phản hồi lỗi. Ví dụ: trong faultstring sau đây, tên chính sách là ExecuteGeocodingRequest và biến là var_response:

    "faultstring": "ServiceCallout[ExecuteGeocodingRequest]: request variable var_response value is not of type Message"

  2. Trong tệp XML chính sách Lệnh gọi dịch vụ không thành công, hãy xác minh rằng tên của biến được đặt trong phần tử <Request> 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 chỉ định một biến yêu cầu có tên là var_response, khớp với nội dung trong faultstring:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ServiceCallout name="ExecuteGeocodingRequest">
    <Request variable="var_response"/>
    <Response>GeocodingResponse</Response>
    <HTTPTargetConnection>
        <URL>http://maps.googleapis.com/maps/api/geocode/json</URL>
    </HTTPTargetConnection>
</ServiceCallout>

  3. Xác định xem biến có phải là loại thông báo yêu cầu hay không:

    1. Tìm mã trong gói Proxy API, nơi biến được xác định trước tiên.
    2. Trong hầu hết các trường hợp, bạn sẽ thấy biến vấn đề được tạo và điền sẵn trong một chính sách khác thực thi trước chính sách Chú thích dịch vụ. Ví dụ: Chính sách Chỉ định thông báo thường được dùng để tạo và điền các biến trong luồng proxy API.
    3. Sau khi tìm ra chính sách trong đó biến được xác định và điền sẵn trước tiên, bạn cần xác định loại biến đó như sau:
      • Kiểm tra giá trị của thuộc tính type (nếu có).
      • Nếu không có thuộc tính type, thì biến được coi là một chuỗi.
    4. Nếu loại của biến không phải là loại yêu cầu thông báo, thì đó là nguyên nhân gây ra lỗi. Bạn có thể tìm hiểu về các biến phổ biến và loại biến trong phần Tài liệu tham khảo về biến.

Ví dụ: giả sử biến var_response được tham chiếu trong chính sách Chú thích dịch vụ được tạo trong chính sách Chỉ định thông báo sau đây. Lưu ý rằng var_response được gán kiểu response. Do đó, loại của biến var_response là thông báo phản hồi.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage name="GenerateGeocodingRequest">
        <AssignTo createNew="true" type="request">GeocodingRequest</AssignTo>
    <AssignTo createNew="true" type="response">var_response</AssignTo>
    <Set>
        <QueryParams>
            <QueryParam name="address">{request.queryparam.postalcode}</QueryParam>
            <QueryParam name="region">{request.queryparam.country}</QueryParam>
            <QueryParam name="sensor">false</QueryParam>
        </QueryParams>
        <Verb>GET</Verb>
    </Set>
    <AssignVariable>
        <Name>PostalCode</Name>
        <Ref>request.queryparam.postalcode</Ref>
    </AssignVariable>
    <AssignVariable>
        <Name>Country</Name>
        <Ref>request.queryparam.country</Ref>
    </AssignVariable>
</AssignMessage>

Hãy nhớ rằng biến var_response được dùng trong phần tử <Request> của Chính sách chú thích dịch vụ.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ServiceCallout name="ExecuteGeocodingRequest">
    <Request variable="var_response"/>
    <Response>GeocodingResponse</Response>
    <HTTPTargetConnection>
        <URL>http://maps.googleapis.com/maps/api/geocode/json</URL>
    </HTTPTargetConnection>
</ServiceCallout>

Vì var_response không phải là loại thông báo yêu cầu (loại của thông báo này là thông báo phản hồi), nên bạn sẽ nhận được mã lỗi: steps.servicecallout.RequestVariableNotRequestMessageType.

Độ phân giải

Đảm bảo rằng biến được đặt trong phần tử <Request> trong chính sách Chú thích dịch vụ không thành công là biến loại yêu cầu thông báo đã tồn tại, hoặc bạn có thể tạo biến loại thông báo yêu cầu mới ngay trong chính sách Chú thích dịch vụ (như giải thích trong tài liệu về chính sách) rồi sử dụng biến đó.

Để chỉnh sửa chính sách này, bạn phải sửa đổi phần tử <Request> để chỉ định một biến hiện có hoặc biến mới thuộc loại thông báo yêu cầu. Biến này sẽ hoạt động trong chính sách Chú thích dịch vụ. Ví dụ:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ServiceCallout name="ExecuteGeocodingRequest">
    <Request variable="GeocodingRequest"/>
    <Response>GeocodingResponse</Response>
    <HTTPTargetConnection>
        <URL>http://maps.googleapis.com/maps/api/geocode/json</URL>
    </HTTPTargetConnection>
</ServiceCallout>

ExecutionFailed

Mã lỗi

steps.servicecallout.ExecutionFailed

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

{
    "fault": {
        "faultstring": "Execution of ServiceCallout [policy_name] failed. Reason: Host not reachable",
        "detail": {
            "errorcode": "steps.servicecallout.ExecutionFailed"
        }
    }
}

hoặc

{
    "fault": {
        "faultstring": "Execution of ServiceCallout [policy_name] failed. Reason: ResponseCode [http_code] is treated as error",
        "detail": {
            "errorcode": "steps.servicecallout.ExecutionFailed"
        }
    }
}

Các nguyên nhân có thể

Nguyên nhân có thể gây ra lỗi này là:

Nguyên nhân Nội dung mô tả
URL không hợp lệ hoặc không đúng định dạng URL đích trong chính sách Chú thích dịch vụ có định dạng không chính xác hoặc có tên máy chủ không hợp lệ hoặc không truy cập được.
Lỗi máy chủ phụ trợ Máy chủ phụ trợ trả về phản hồi lỗi 4XX hoặc 5XX.

Nguyên nhân: URL không hợp lệ hoặc không đúng định dạng

URL đích trong chính sách Chú thích dịch vụ có định dạng không chính xác hoặc có tên máy chủ không hợp lệ hoặc không truy cập được.

Chẩn đoán

  1. Xác định chính sách về Lời gọi dịch vụ gây ra lỗi. Tên chính sách xuất hiện trong phần tử faultstring của phản hồi lỗi. Ví dụ: trong faultstring sau đây, tên của chính sách Lời gọi dịch vụ không thành công là ExecuteGeocodingRequest.

    "faultstring": "ServiceCallout[ExecuteGeocodingRequest]"

  2. Trong chính sách về Chú thích dịch vụ không hợp lệ, hãy kiểm tra phần tử <URL>. Nếu tên máy chủ có định dạng không chính xác hoặc có tên máy chủ không hợp lệ hoặc không thể truy cập được, thì đó là nguyên nhân gây ra lỗi này. Ví dụ: Chính sách về chú thích dịch vụ sau đây chỉ định một <URL> không hợp lệ:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ServiceCallout name="ExecuteGeocodingRequest">
    <Request variable="GeocodingRequest"/>
    <Response>GeocodingResponse</Response>
    <HTTPTargetConnection>
        <URL>http://</URL>
    </HTTPTargetConnection>
</ServiceCallout>

    Phần tử <URL> chỉ có giao thức http:// nhưng không có tên máy chủ hợp lệ; do đó, chính sách Chú thích dịch vụ không thành công với lỗi: Execution of ServiceCallout ExecuteGeocodingRequest failed. Reason: Host not reachable.

Độ phân giải

Đảm bảo rằng phần tử <URL> trong chính sách về Chú thích dịch vụ không hợp lệ có một URL hợp lệ với tên máy chủ có thể truy cập được.

Để sửa chính sách Chú thích dịch vụ hiển thị ở trên, bạn có thể sửa đổi phần tử <URL> để chỉ định một URL hợp lệ:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ServiceCallout name="ExecuteGeocodingRequest">
    <Request variable="GeocodingRequest"/>
    <Response>GeocodingResponse</Response>
    <HTTPTargetConnection>
        <URL>http://maps.googleapis.com/maps/api/geocode/json</URL>
    </HTTPTargetConnection>
</ServiceCallout>

Nguyên nhân: Lỗi máy chủ phụ trợ

Máy chủ phụ trợ trả về phản hồi lỗi 4XX hoặc 5XX.

Chẩn đoán

  1. Xác định chính sách Chú thích cho dịch vụ gây ra lỗi. Tên chính sách xuất hiện trong phần tử faultstring của phản hồi lỗi. Ví dụ: trong faultstring sau đây, tên của chính sách Lời gọi dịch vụ không thành công là ExecuteGeocodingRequest.

    "faultstring": "ServiceCallout[ExecuteGeocodingRequest]

  2. Kiểm tra faultstring trong phần nội dung phản hồi lỗi và kiểm tra xem có mã phản hồi 4XX hoặc 5XX nào được liệt kê trong Reason hay không. Ví dụ: chuỗi lỗi sau đây cho biết rõ rằng máy chủ phụ trợ đã trả về mã phản hồi 502:

    "faultstring": "Execution of ServiceCallout ExecuteGeocodingRequest failed. Reason: ResponseCode 502 is treated as error"

Độ phân giải

Sau khi xác định mã phản hồi lỗi, bạn có thể khắc phục vấn đề này giống như cách khắc phục mọi lỗi 4XX hoặc 5XX. Hãy tham khảo Cẩm nang về lỗi thời gian chạy (4XX/5XX) để được hướng dẫn cách khắc phục sự cố và giải quyết các lỗi 4XX hoặc 5XX.