使用APICTL从WSO2 APIM导出API时遭遇路径错误问题

使用apictl从WSO2 APIM导出API时，提取临时文件后出现路径找不到的错误，无法完成最终归档创建。操作步骤及错误日志如下：

PS C:\WINDOWS\system32> apictl login dev -u admin -p admin --insecure
Warning: Using --password in CLI is not secure. Use --password-stdin
Logged into APIM in dev environment
WARNING: credentials are stored as a plain text in C:\Users\youssef.gamal\.wso2apictl.local\keys.json
PS C:\WINDOWS\system32> apictl export api --name GenericCso --version 1.0.0 --environment dev --verbose
Executed ImportExportCLI (apictl) on Wed, 03 Jul 2024 19:49:01 EET
[INFO]: Insecure: false
[INFO]: api called
[INFO]: connecting to https://localhost:9943/oauth2/token
[INFO]: ExportAPI: URL: https://localhost:9943/publisher/apis/api/am/publisher/v3/apis/export?name=GenericCso&version=1.0.0&providerName=&preserveStatus=true&format=YAML
[INFO]: ResponseStatus: 200
[INFO]: Extracting C:\Users\YOUSSE~1.GAM\AppData\Local\Temp\apim644902823\GenericCso_1.0.0.zip to C:\Users\YOUSSE~1.GAM\AppData\Local\Temp\apim198201050
apictl: Error creating the final zip archive Reason: Stat : The system cannot find the path specified.
Exit status 1
PS C:\WINDOWS\system32> apictl get envs
NAME                API MANAGER ENDPOINT     REGISTRATION ENDPOINT   TOKEN ENDPOINT                        PUBLISHER ENDPOINT                      DEVPORTAL ENDPOINT   ADMIN ENDPOINT      MI MANAGEMENT ENDPOINT
dev                 https://localhost:9943                           https://localhost:9943/oauth2/token   https://localhost:9943/publisher/apis                            

已尝试通用AI解决方案但无效，寻求有效解决办法。

1. 检查临时目录状态 #

• 手动访问日志中提到的临时路径C:\Users\YOUSSE~1.GAM\AppData\Local\Temp，确认目录存在且当前用户拥有读写权限
• 删除该目录下所有以apim开头的临时文件夹，避免残留文件干扰导出流程

2. 指定明确的导出输出目录 #

导出时添加--output参数，指定一个提前创建好、用户有权限的目录，示例命令：

apictl export api --name GenericCso --version 1.0.0 --environment dev --verbose --output "C:\APIM_Exports"

3. 修复apictl配置目录权限 #

• 定位到C:\Users\youssef.gamal\.wso2apictl.local目录，右键选择「属性」→「安全」→「编辑」，为当前用户添加「完全控制」权限
• 确认keys.json文件未被锁定或设置为只读

4. 升级apictl版本 #

该问题可能是旧版本apictl的已知bug，下载并安装最新稳定版apictl，替换现有版本后重试导出操作

5. 检查API资源路径合法性 #

登录WSO2 APIM Publisher后台，查看GenericCso API的所有资源路径，确保没有包含空格、特殊符号或无效字符，这类异常配置可能导致导出时路径解析失败

内容的提问来源于stack exchange，提问作者Youssef Gamal