การแก้ปัญหาข้อผิดพลาดรันไทม์ของคำขอราคาเสนอบริการ

คุณกำลังดูเอกสารประกอบของ Apigee Edge
ไปที่เอกสารประกอบของ Apigee X ข้อมูล

RequestVariableNotMessageType

รหัสข้อผิดพลาด

steps.servicecallout.RequestVariableNotMessageType

เนื้อหาการตอบกลับข้อผิดพลาด

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

สาเหตุ

ข้อผิดพลาดนี้เกิดขึ้นหากตัวแปรที่ระบุในองค์ประกอบ <Request> ของนโยบายการเรียกบริการไม่ใช่ประเภทข้อความ หากตัวแปรเป็นสตริงหรือประเภทอื่นๆ ที่ไม่ใช่ข้อความ คุณจะเห็นข้อผิดพลาดนี้

ตัวแปรประเภทข้อความจะเป็นตัวแทนของคำขอและการตอบกลับ HTTP ทั้งหมด ตัวแปรโฟลว์ Edge ในตัว request, response และ message เป็นข้อความประเภท ดูข้อมูลเพิ่มเติมเกี่ยวกับตัวแปรข้อความได้ที่ข้อมูลอ้างอิงตัวแปร

การวินิจฉัย

1. ระบุนโยบายการเรียกบริการซึ่งเกิดข้อผิดพลาดและชื่อของตัวแปรที่มีประเภทไม่ถูกต้อง คุณจะพบทั้ง 2 รายการนี้ในองค์ประกอบ faultstring ของการตอบกลับข้อผิดพลาด ตัวอย่างเช่น ใน faultstring ต่อไปนี้ ชื่อนโยบายคือ ExecuteGeocodingRequest และตัวแปรคือ PostalCode

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

2. ใน XML ของนโยบายคำขอราคาเสนอบริการล้มเหลว ให้ตรวจสอบว่าชื่อของตัวแปรที่ตั้งค่าไว้ในองค์ประกอบ <Request> ตรงกับชื่อตัวแปรที่ระบุในสตริงข้อผิดพลาด (ขั้นตอนที่ 1 ด้านบน) ตัวอย่างเช่น นโยบายต่อไปนี้ระบุตัวแปรคำขอชื่อ PostalCode ซึ่งตรงกับสิ่งที่อยู่ใน 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. ตรวจสอบว่าตัวแปรนี้เป็นข้อความประเภทหรือไม่

   1. ค้นหาโค้ดภายในกลุ่มพร็อกซี API ที่มีการระบุตัวแปรไว้ก่อน
   2. ในกรณีส่วนใหญ่ คุณจะพบว่ามีการสร้างและป้อนข้อมูลตัวแปรที่เป็นปัญหาในนโยบายอื่นที่ทำงานก่อนนโยบายการเรียกบริการ ตัวอย่างเช่น นโยบายกําหนดข้อความมักจะใช้เพื่อสร้างและป้อนข้อมูลตัวแปรในขั้นตอนพร็อกซี API
   3. เมื่อคุณทราบถึงนโยบายที่กำหนดและเติมค่าตัวแปรก่อนแล้ว คุณจะต้องกำหนดประเภทของตัวแปรนั้น ดังนี้
      • ตรวจสอบค่าของแอตทริบิวต์ type (หากมี)
      • หากไม่มีแอตทริบิวต์ type ระบบจะถือว่าตัวแปรเป็นสตริง
   4. หากประเภทของตัวแปรไม่ใช่ข้อความ (เช่น สตริง) นั่นเป็นสาเหตุของข้อผิดพลาด คุณดูข้อมูลเกี่ยวกับตัวแปรทั่วไปและประเภทของตัวแปรได้ในข้อมูลอ้างอิงตัวแปร

ตัวอย่างเช่น สมมติว่ามีการสร้างตัวแปร PostalCode ที่อ้างอิงในนโยบายข้อความไฮไลต์บริการในนโยบายการมอบหมายข้อความต่อไปนี้ โปรดทราบว่า PostalCode ได้รับการกำหนดค่าของตัวแปรโฟลว์ request.queryparam.postalcode ค่านี้เป็นสตริง เนื่องจากไม่มีแอตทริบิวต์ type ในการกำหนดตัวแปร

<?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>

ในตอนนี้ โปรดระลึกว่ามีการใช้ตัวแปร PostalCode ในองค์ประกอบ <Request> ของนโยบายการเรียกบริการ ดังนี้

<?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>

เนื่องจาก PostalCode ไม่ใช่ประเภทข้อความ (ในตัวอย่างนี้เป็นสตริง) คุณจะได้รับรหัสข้อผิดพลาด: steps.servicecallout.RequestVariableNotMessageType

ความละเอียด

ตรวจสอบว่าตัวแปรที่ตั้งค่าไว้ในองค์ประกอบ <Request> ในนโยบายคำขอราคาเสนอบริการล้มเหลวเป็นตัวแปรโฟลว์ประเภทข้อความที่มีอยู่ หรือคุณอาจสร้างตัวแปรประเภทข้อความใหม่ได้โดยตรงในนโยบายข้อความไฮไลต์บริการ (ตามที่อธิบายไว้ในเอกสารประกอบของนโยบาย) แล้วใช้ตัวแปรดังกล่าว

หากต้องการแก้ไขนโยบาย คุณต้องแก้ไของค์ประกอบ <Request> เพื่อระบุตัวแปรที่มีอยู่หรือตัวแปรใหม่ที่เป็นประเภทข้อความ ตัวอย่างเช่น ตัวแปร GeocodingRequest ที่ตั้งค่าไว้ในนโยบายการกำหนดข้อความเป็นประเภท "ข้อความ" และจะใช้งานได้ตามปกติในนโยบายการเรียกบริการ เช่น

<?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

รหัสข้อผิดพลาด

steps.servicecallout.RequestVariableNotRequestMessageType

เนื้อหาการตอบกลับข้อผิดพลาด

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

สาเหตุ

ข้อผิดพลาดนี้เกิดขึ้นหากตัวแปรที่ระบุในองค์ประกอบ <Request> ของนโยบายการเรียกบริการไม่ใช่ประเภทข้อความคำขอ หากตัวแปรเป็นประเภทข้อความตอบกลับ สตริง หรือประเภทอื่นๆ คุณจะเห็นข้อผิดพลาดนี้

ตัวแปรประเภทข้อความจะเป็นตัวแทนของคำขอและการตอบกลับ HTTP ทั้งหมด ตัวแปรโฟลว์ Edge ในตัว request, response และ message เป็นข้อความประเภท ดูข้อมูลเพิ่มเติมเกี่ยวกับตัวแปรข้อความได้ที่ข้อมูลอ้างอิงตัวแปร

การวินิจฉัย

1. ระบุนโยบายการเรียกบริการซึ่งเกิดข้อผิดพลาดและชื่อของตัวแปรที่มีประเภทไม่ถูกต้อง คุณจะพบทั้ง 2 รายการนี้ในองค์ประกอบ faultstring ของการตอบกลับข้อผิดพลาด ตัวอย่างเช่น ใน faultstring ต่อไปนี้ ชื่อนโยบายคือ ExecuteGeocodingRequest และตัวแปรคือ var_response

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

2. ใน XML ของนโยบายคำขอราคาเสนอบริการล้มเหลว ให้ตรวจสอบว่าชื่อของตัวแปรที่ตั้งค่าไว้ในองค์ประกอบ <Request> ตรงกับชื่อตัวแปรที่ระบุในสตริงข้อผิดพลาด (ขั้นตอนที่ 1 ด้านบน) ตัวอย่างเช่น นโยบายต่อไปนี้ระบุตัวแปรคำขอชื่อ var_response ซึ่งตรงกับสิ่งที่อยู่ใน 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. ระบุว่าตัวแปรเป็นประเภทข้อความคำขอหรือไม่

   1. ค้นหาโค้ดภายในกลุ่มพร็อกซี API ที่มีการระบุตัวแปรไว้ก่อน
   2. ในกรณีส่วนใหญ่ คุณจะพบว่ามีการสร้างและป้อนข้อมูลตัวแปรที่เป็นปัญหาในนโยบายอื่นที่ทำงานก่อนนโยบายการเรียกบริการ ตัวอย่างเช่น นโยบายกําหนดข้อความมักจะใช้เพื่อสร้างและป้อนข้อมูลตัวแปรในขั้นตอนพร็อกซี API
   3. เมื่อคุณทราบถึงนโยบายที่กำหนดและเติมค่าตัวแปรก่อนแล้ว คุณจะต้องกำหนดประเภทของตัวแปรนั้น ดังนี้
      • ตรวจสอบค่าของแอตทริบิวต์ type (หากมี)
      • หากไม่มีแอตทริบิวต์ type ระบบจะถือว่าตัวแปรเป็นสตริง
   4. หากประเภทของตัวแปรไม่ใช่ประเภทข้อความคำขอ นั่นเป็นสาเหตุของข้อผิดพลาด คุณดูข้อมูลเกี่ยวกับตัวแปรทั่วไปและประเภทของตัวแปรได้ในข้อมูลอ้างอิงตัวแปร

ตัวอย่างเช่น สมมติว่ามีการสร้างตัวแปร var_response ที่อ้างอิงในนโยบายข้อความไฮไลต์บริการในนโยบายการมอบหมายข้อความต่อไปนี้ โปรดทราบว่า var_response จะเป็นประเภท response ดังนั้น ประเภทของตัวแปร var_response จึงเป็นข้อความตอบกลับ

<?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>

อย่าลืมว่ามีการใช้ตัวแปร var_response ในองค์ประกอบ <Request> ของนโยบายคำขอราคาเสนอบริการ

<?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>

เนื่องจาก var_response ไม่ใช่ประเภทข้อความคำขอ (ประเภทเป็นข้อความตอบกลับ) คุณจะได้รับรหัสข้อผิดพลาด: steps.servicecallout.RequestVariableNotRequestMessageType

ความละเอียด

ตรวจสอบว่าตัวแปรที่กำหนดไว้ในองค์ประกอบ <Request> ในนโยบายคำขอราคาเสนอบริการล้มเหลวเป็นตัวแปรประเภทข้อความคําขอที่มีอยู่ หรือคุณอาจสร้างตัวแปรประเภทข้อความคําขอใหม่โดยตรงในนโยบายข้อความไฮไลต์บริการ (ตามที่อธิบายไว้ในเอกสารประกอบของนโยบาย) แล้วใช้ตัวแปรดังกล่าว

หากต้องการแก้ไขนโยบาย คุณต้องแก้ไของค์ประกอบ <Request> เพื่อระบุตัวแปรที่มีอยู่หรือตัวแปรใหม่ที่เป็นประเภทข้อความคำขอ และองค์ประกอบดังกล่าวจะทำงานในนโยบายคำขอราคาเสนอบริการ เช่น

<?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

รหัสข้อผิดพลาด

steps.servicecallout.ExecutionFailed

เนื้อหาการตอบกลับข้อผิดพลาด

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

หรือ

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

สาเหตุที่เป็นไปได้

สาเหตุที่เป็นไปได้สำหรับข้อผิดพลาดนี้คือ

สาเหตุ	คำอธิบาย
URL ไม่ถูกต้องหรือผิดรูปแบบ	URL เป้าหมายในนโยบายคำขอราคาเสนอบริการมีรูปแบบที่ไม่ถูกต้องหรือมีชื่อโฮสต์ที่ไม่ถูกต้องหรือเข้าถึงไม่ได้
ข้อผิดพลาดของเซิร์ฟเวอร์แบ็กเอนด์	เซิร์ฟเวอร์แบ็กเอนด์แสดงการตอบกลับที่เป็นข้อผิดพลาด 4XX หรือ 5XX

สาเหตุ: URL ไม่ถูกต้องหรือผิดรูปแบบ

URL เป้าหมายในนโยบายคำขอราคาเสนอบริการมีรูปแบบที่ไม่ถูกต้องหรือมีชื่อโฮสต์ที่ไม่ถูกต้องหรือเข้าถึงไม่ได้

การวินิจฉัย

1. ระบุนโยบายคำขอราคาเสนอบริการที่ทำให้เกิดข้อผิดพลาด ชื่อนโยบายจะปรากฏในองค์ประกอบ faultstring ของการตอบกลับข้อผิดพลาด ตัวอย่างเช่น ใน faultstring ต่อไปนี้ ชื่อของนโยบายการเรียกบริการที่ล้มเหลวคือ ExecuteGeocodingRequest

   "faultstring": "ServiceCallout[ExecuteGeocodingRequest]"

2. ตรวจสอบองค์ประกอบ <URL> ในนโยบายคำขอราคาเสนอการบริการที่ล้มเหลว หาก URL ผิดรูปแบบหรือมีชื่อโฮสต์ที่ไม่ถูกต้องหรือไม่สามารถเข้าถึงได้ นั่นเป็นสาเหตุของข้อผิดพลาดนี้ ตัวอย่างเช่น นโยบายคำขอราคาเสนอบริการต่อไปนี้ระบุ <URL> ที่ไม่ถูกต้อง

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

   องค์ประกอบ <URL> มีเฉพาะโปรโตคอล http:// แต่ไม่มีชื่อโฮสต์ที่ถูกต้อง นโยบายการเรียกบริการจึงทำงานไม่สำเร็จโดยมีข้อผิดพลาด Execution of ServiceCallout ExecuteGeocodingRequest failed. Reason: Host not reachable

ความละเอียด

ตรวจสอบว่าองค์ประกอบ <URL> ในนโยบายคำขอราคาเสนอบริการที่ล้มเหลวมี URL ที่ถูกต้องพร้อมชื่อโฮสต์ที่เข้าถึงได้

หากต้องการแก้ไขนโยบายไฮไลต์ของบริการที่แสดงข้างต้น ให้แก้ไของค์ประกอบ <URL> เพื่อระบุ URL ที่ถูกต้อง ดังนี้

<?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>

สาเหตุ: ข้อผิดพลาดของเซิร์ฟเวอร์แบ็กเอนด์

เซิร์ฟเวอร์แบ็กเอนด์แสดงการตอบกลับที่เป็นข้อผิดพลาด 4XX หรือ 5XX

การวินิจฉัย

1. ระบุนโยบายคำขอราคาเสนอบริการที่ทำให้เกิดข้อผิดพลาด ชื่อนโยบายจะปรากฏในองค์ประกอบ faultstring ของการตอบกลับข้อผิดพลาด ตัวอย่างเช่น ใน faultstring ต่อไปนี้ ชื่อของนโยบายการเรียกบริการที่ล้มเหลวคือ ExecuteGeocodingRequest

   "faultstring": "ServiceCallout[ExecuteGeocodingRequest]

2. ตรวจสอบ faultstring ในเนื้อหาการตอบสนองข้อผิดพลาดและดูว่ามีโค้ดการตอบกลับ 4XX หรือ 5XX แสดงอยู่ใน Reason หรือไม่ ตัวอย่างเช่น สตริงข้อผิดพลาดต่อไปนี้แสดงให้เห็นอย่างชัดเจนว่ามีการส่งคืนรหัสการตอบสนอง 502 จากเซิร์ฟเวอร์แบ็กเอนด์

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

ความละเอียด

เมื่อทราบโค้ดตอบกลับข้อผิดพลาดแล้ว คุณจะแก้ปัญหานี้ได้เช่นเดียวกับการแก้ไขข้อผิดพลาด 4XX หรือ 5XX ดูวิธีการแก้ปัญหาและการแก้ไขข้อผิดพลาด 4XX หรือ 5XX ได้ในPlaybook เกี่ยวกับข้อผิดพลาดรันไทม์ (4XX/5XX)