iflytek/astron-agent · error · BusinessException

Failed to query APPID credentials. Please check if APPID…

Error message

Failed to query APPID credentials. Please check if APPID belongs to you or if APPID has been deleted, APPID=

What it means

Same error as the APPID credential lookup failure, but the message shows 'APPID=' with no value — the appId argument passed into parseRemoteCredential was null (null concatenation yields the empty string). The remote lookup therefore ran with no identifier and naturally returned no credential.

Solutions

1. Trace where getAkSk/remoteCallAkSk obtains appId and find why it is null (missing config property or null entity field).
2. Guard the entry point: reject null/blank appId before the remote call with a clear client-facing message.
3. In parseRemoteCredential, build the message with String.valueOf or a blank-check so the log clearly indicates a missing identifier.
4. Fix the configuration/record so the appId is populated, then retry.

Example fix

// before
String errMsg = "Failed to query APPID credentials... APPID=" + appId;
// after
if (appId == null || appId.isBlank()) {
    throw new BusinessException(ResponseEnum.RESPONSE_FAILED, "appId is required but was not provided");
}
String errMsg = "Failed to query APPID credentials... APPID=" + appId;

// before calling getAkSk/remoteCallAkSk
if (appId == null || appId.isBlank()) {
    throw new BusinessException(ResponseEnum.RESPONSE_FAILED, "appId must be configured before credential lookup");
}

boolean hasAppId(App app) {
    return app != null && app.getAppId() != null && !app.getAppId().isBlank();
}

try {
    AkSk akSk = appService.getAkSk(appId);
} catch (BusinessException e) {
    if (e.getMessage() != null && e.getMessage().endsWith("APPID=")) {
        // appId was null — fix configuration, not the remote service
        log.error("appId missing in configuration");
    }
}

When it happens

Trigger: getAkSk/remoteCallAkSk invoked with a null appId — e.g. the app record or its config was never populated, a lookup returned null and was forwarded directly, or a request field was absent — and parseRemoteCredential built the message via string concatenation of null.

Common situations: Missing APPID in application configuration/environment; DB record for the app missing the appId column value; upstream API response mapped to an object whose appId field was never set before the credential call.

Understand the failure class

Background: "empty response", "returned no data", "empty embeddings": what HTTP 200-with-empty-body errors mean across libraries — this error's family across 36 libraries.

Related errors

• 8001
• -40005
• APPID_CANNOT_EMPTY
• Artifact upload credential is missing or invalid
• Cannot find appid authentication information

AI-assisted analysis of iflytek/astron-agent@5e758547a8 (2026-09-12). Data as JSON: /api/errors/ccaecb23529e80a4. Report an issue: GitHub.

Appendix: source

Thrown at console/backend/toolkit/src/main/java/com/iflytek/astron/console/toolkit/service/extra/AppService.java:109

        String resp;
        try {
            resp = HeaderAuthHttpTool.tenantGet(
                    appUrl, apiUrl.getApiKey(), apiUrl.getApiSecret());
        } catch (NoSuchAlgorithmException | InvalidKeyException | IOException e) {
            throw new RuntimeException(e);
        }
        return parseRemoteCredential(resp, appId, "uncached");
    }

    private AkSk parseRemoteCredential(String response, String appId, String lookupMode) {
        Object data = CommonTool.checkSystemCallResponse(response);
        String errMsg = "Failed to query APPID credentials. Please check if APPID belongs to you or if APPID has been deleted, APPID=" + appId;
        if (data == null) {
            throw new BusinessException(ResponseEnum.RESPONSE_FAILED, errMsg);
        }
        JSONArray array = JSON.parseArray(data.toString());
        if (CollectionUtils.isEmpty(array)) {
            throw new BusinessException(ResponseEnum.RESPONSE_FAILED, errMsg);
        }
        AkSk credential = array.getObject(0, AkSk.class);
        log.info(
                "APP credential query succeeded, appId={}, mode={}, responseChars={}",
                appId,
                lookupMode,
                response == null ? 0 : response.length());
        return credential;
    }

    /**
     * Handle special application IDs that have predefined credentials
     *
     * @param appId The application ID to check
     * @return AkSk object if this is a special app, null otherwise
     */
    private AkSk specialAppHandle(String appId) {
        if (appId.equals(commonConfig.getAppId())) {

View on GitHub (pinned to 5e758547a8)