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

Khắc phục sự cố thời gian chạy về Hoạt động bản đồ giá trị khoá

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

UnsupportedOperationException

Mã lỗi

java.lang.UnsupportedOperationException

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

{
   "fault":{
      "faultstring":"java.lang.UnsupportedOperationException",
      "detail":{
         "errorcode":"Internal Server Error"
      }
   }
}

Nguyên nhân

Lỗi này xảy ra nếu bạn đặt thuộc tính mapIdentifier thành một chuỗi trống trong chính sách Thao tác ánh xạ giá trị khoá.

Chẩn đoán

Kiểm tra tất cả chính sách về Thao tác ánh xạ khoá-giá trị trong Proxy API cụ thể nơi xảy ra lỗi. Nếu có bất kỳ chính sách Hoạt động bản đồ giá trị khoá nào trong đó thuộc tính mapIdentifier được đặt thành một chuỗi trống, thì đó là nguyên nhân gây ra lỗi.

Ví dụ: Chính sách Thao tác ánh xạ khoá-giá trị sau đây có mapIdentifier trống:

<KeyValueMapOperations async="false" continueOnError="false" enabled="true" name="StoreKvm" mapIdentifier="">
    <DisplayName>StoreKvm</DisplayName>
    <Properties/>
    <ExclusiveCache>false</ExclusiveCache>
    <ExpiryTimeInSecs>300</ExpiryTimeInSecs>
    <Put override="true">
        <Key>
            <Parameter ref="request.queryparam.key"/>
        </Key>
        <Value ref="request.queryparam.value"/>
    </Put>
    <Scope>apiproxy</Scope>
</KeyValueMapOperations>

Độ phân giải

Đảm bảo rằng thuộc tính mapIdentifier được đặt thành một bản đồ khoá-giá trị hợp lệ trong Chính sách về hoạt động bản đồ khoá-giá trị.

Để sửa chính sách mẫu nêu trên, bạn có thể chỉ định mapIdentifier cho liên kết khoá-giá trị UserLocationMap hiện có.

<KeyValueMapOperations async="false" continueOnError="false" enabled="true" name="StoreKvm" mapIdentifier="UserLocationMap">
    <DisplayName>StoreKvm</DisplayName>
    <Properties/>
    <ExclusiveCache>false</ExclusiveCache>
    <ExpiryTimeInSecs>300</ExpiryTimeInSecs>
    <Put override="true">
        <Key>
            <Parameter ref="request.queryparam.key"/>
        </Key>
        <Value ref="request.queryparam.value"/>
    </Put>
    <Scope>apiproxy</Scope>
</KeyValueMapOperations>

SetVariableFailed

Mã lỗi

steps.keyvaluemapoperations.SetVariableFailed

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

{
   "fault":{
      "faultstring":"Failed to set variable variable_name in KeyValueMapStepDefinition policy_name",
      "detail":{
         "errorcode":"steps.keyvaluemapoperations.SetVariableFailed"
      }
   }
}

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

{
   "fault":{
      "faultstring":"Failed to set variable myvar in KeyValueMapStepDefinition EncryptedKVM",
      "detail":{
         "errorcode":"steps.keyvaluemapoperations.SetVariableFailed"
      }
   }
}

Nguyên nhân

Lỗi này xảy ra nếu bạn cố truy xuất giá trị từ liên kết khoá-giá trị đã mã hoá và đặt giá trị thành một biến có tên không có tiền tố private.. Chiến lược phát hành đĩa đơn cần thiết cho các mục đích bảo mật cơ bản trong khi gỡ lỗi, các giá trị đã mã hoá từ proxy API Theo dõi và các phiên gỡ lỗi.

Chẩn đoán

1. Xác định chính sách Thao tác ánh xạ khoá-giá trị nơi xảy ra lỗi và tên của biến không thể đặt giá trị. 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à EncryptedKVM và biến là myvar:

  "faultstring":"Failed to set variable myvar in KeyValueMapStepDefinition EncryptedKVM"

1. Trong tệp XML của chính sách Thao tác bản đồ giá trị khoá bị lỗi, hãy xác minh rằng tên của biến được chỉ định trong thuộc tính assignTo của phần tử <Get> 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 Hoạt động bản đồ giá trị khoá sau đây chỉ định một biến có tên myvar trong phần tử <Get>, khớp với biến trong faultstring:

  <KeyValueMapOperations async="false" continueOnError="false" enabled="true" name="Key-Value-Map-Operations-1" mapIdentifier="testEncrypted">
      <DisplayName>KeyValueMapOperations-1</DisplayName>
      <Properties/>
      <ExclusiveCache>false</ExclusiveCache>
      <ExpiryTimeInSecs>300</ExpiryTimeInSecs>
      <Get assignTo="myvar" index="1">
          <Key>
              <Parameter>foo</Parameter>
          </Key>
      </Get>
      <Scope>environment</Scope>
  </KeyValueMapOperations>

Kiểm tra xem bản đồ giá trị khoá được chỉ định trong thuộc tính mapIdentifier có phải là KVM đã mã hoá hay không. Nếu KVM được mã hoá ở phạm vi môi trường, bạn có thể xác minh rằng KVM đã được mã hoá trong giao diện người dùng Edge. Ngược lại, nếu tệp được tạo ở phạm vi tổ chức hoặc apiproxy, bạn cần để sử dụng API Quản lý nhằm xác minh xem mã có được mã hoá hay không. Xem thêm phần Quản lý và sử dụng KVM.

Cách kiểm tra xem KVM trong phạm vi môi trường có được mã hoá trong giao diện người dùng Edge hay không:
1. Trong giao diện người dùng Edge, hãy nhấp vào Quản trị trong trình đơn điều hướng bên trái.
2. Nhấp vào Môi trường.
3. Nhấp vào Bản đồ giá trị chính.
4. Tìm Bản đồ khoá-giá trị mà bạn muốn sử dụng.
5. Nhấp vào mũi tên ở bên trái tên để mở rộng danh sách giá trị.
6. Các giá trị trên Bản đồ giá trị khoá được mã hoá hiển thị các giá trị được che giấu bằng dấu hoa thị trong giao diện người dùng (*****) như trong phần Giới thiệu về KVM được mã hoá.
Để kiểm tra xem một KVM ở cấp tổ chức, môi trường hoặc apiproxy có được mã hoá hay không, hãy sử dụng API Quản lý. Nếu bạn sử dụng API, một phản hồi mẫu cho thấy cả chế độ cài đặt đã mã hoá và dấu hoa thị cho giá trị sẽ có dạng như sau:
```
{
  "encrypted": true,
  "entry": [
    {
      "name": "foo",
      "value": "*****"
    }
  ],
  "name": "encrypted"
}
```
Nếu bản đồ giá trị khoá là KVM đã mã hoá và tên biến được sử dụng trong thuộc tính assignTo của phần tử <Get> không có tiền tố private. Tiếp đó, đó là nguyên nhân gây ra lỗi.

Trong ví dụ về Chính sách hoạt động bản đồ giá trị khoá nêu trên, liên kết giá trị khoá testEncrypted được mã hoá còn tên biến myvar không có tiền tố private. Do đó, bạn sẽ nhận được mã lỗi:
```
steps.keyvaluemapoperations.SetVariableFailed
```

Độ phân giải

Đảm bảo tên biến có tiền tố private. trong thuộc tính assignTo của phần tử <Get> trong chính sách Hoạt động bản đồ giá trị khoá nếu liên kết khoá-giá trị đã sử dụng sẽ được mã hoá.

Để sửa chính sách Hoạt động bản đồ giá trị khoá mẫu nêu trên, bạn có thể sửa đổi giá trị của thuộc tính assignTo cho private.myvar:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<KeyValueMapOperations async="false" continueOnError="false" enabled="true" name="Key-Value-Map-Operations-1" mapIdentifier="testEncrypted">
    <DisplayName>KeyValueMapOperations-1</DisplayName>
    <Properties/>
    <ExclusiveCache>false</ExclusiveCache>
    <ExpiryTimeInSecs>300</ExpiryTimeInSecs>
    <Get assignTo="private.myvar" index="1">
        <Key>
            <Parameter>foo</Parameter>
        </Key>
    </Get>
    <Scope>environment</Scope>
</KeyValueMapOperations>