Trang này được dịch bởi Cloud Translation API.

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 về 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 kiểu thông báo đại diện cho toàn bộ các yêu cầu và phản hồi HTTP. Các biến flow tích hợp sẵn trong 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

Xác định chính sách Chú thích cho dịch vụ đang xảy ra lỗi và tên của biến có loại 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, 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"
Trong tệp XML của Chính sách chú thích dịch vụ bị lỗi, 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 PostalCode, khớp với biến 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>
```
Xác định xem biến này có thuộc loại thông báo hay không:
1. Tìm mã trong gói API Proxy, nơi biến được xác định đầu 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 mà trong đó biến được xác định và điề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 biến không phải là thông báo (chẳng hạn như một 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 tin nhắn sau đây. Xin lưu ý rằng PostalCode được gán giá trị của biến luồng request.queryparam.postalcode. Giá trị này là một chuỗi vì không có thuộc tính type trong phép gán 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 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. 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 về 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 chú thích dịch vụ không thuộc loại thông báo yêu cầu. 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.

Các biến loại Message biểu thị toàn bộ các 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 đều 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

Xác định chính sách Chú thích cho dịch vụ đang xảy ra lỗi và tên của biến có loại 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, 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"
Trong tệp XML của Chính sách chú thích dịch vụ bị lỗi, 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 var_response, khớp với biến 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>
```
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 API Proxy, nơi biến được xác định đầu 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 mà trong đó biến được xác định và điề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 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 tin nhắn sau đây. Xin lưu ý rằng var_response được cấp kiểu response. Do đó, loại 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 thuộc 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 Lời gọi dịch vụ không thành công là biến loại thông báo yêu cầu hiện có 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 Lời gọi dịch vụ (như giải thích trong tài liệu chính sách) và 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 về 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 đúng hoặc có tên máy chủ không hợp lệ hoặc không thể 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 thể truy cập được.

Chẩn đoán

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 về Chú thích dịch vụ không thành công là ExecuteGeocodingRequest.

"faultstring": "ServiceCallout[ExecuteGeocodingRequest]"
Trong chính sách Chú thích dịch vụ không thành công, hãy kiểm tra phần tử <URL>. Nếu tên máy chủ không đúng định dạng 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 chú thích cho 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ụ sẽ không hoạt động kèm theo 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 Chú thích dịch vụ không thành công có URL hợp lệ chứa 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

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 về Chú thích dịch vụ không thành công là ExecuteGeocodingRequest.

"faultstring": "ServiceCallout[ExecuteGeocodingRequest]
Kiểm tra faultstring trong phần nội dung phản hồi lỗi rồi 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 chỉ ra rõ ràng rằng mã phản hồi 502 được máy chủ phụ trợ trả về:

"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 sự cố này giống như mọi lỗi 4XX hoặc 5XX. 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.