iflytek/astron-agent · error · BusinessException

8322

8322

Error message

toolbox.name.empty

What it means

TOOLBOX_NAME_EMPTY (code 8322) thrown by ToolBoxController.createTool when the request body's name field is null. The controller performs null checks on name and description before calling toolBoxService.createTool. Note the same enum is reused for a missing description, so 'toolbox.name.empty' can actually mean either field is missing.

Solutions

1. Include both name and description (non-null) in the create-tool request body.
2. Add required-field checks client-side before submitting the form.
3. Server-side, distinguish the two failures: throw TOOLBOX_NAME_EMPTY for name and a dedicated TOOLBOX_DESCRIPTION_EMPTY enum for description.
4. Add @NotBlank bean-validation annotations on ToolBoxDto so Spring returns a 400 with field-level messages.

Example fix

// before
{"description": "my plugin"}
// after
{"name": "my-plugin", "description": "my plugin"}

function canCreateTool(dto) {
  return dto != null && dto.name != null && dto.description != null;
}

const hasName = (dto) => typeof dto?.name === 'string' && dto.name.trim().length > 0;

try {
  await api.createTool(dto);
} catch (e) {
  if (e.code === 8322) {
    form.name.$error = !dto.name;
    form.description.$error = !dto.description;
  } else throw e;
}

When it happens

Trigger: POST /create-tool with a JSON body lacking the name field (e.g. {"description":"my plugin"}) — or, per line 37, lacking the description field.

Common situations: Frontend form submitted before the name input is filled; client builds the DTO dynamically and omits null keys; renamed API fields after a version change so the client still sends an old field name.

Understand the failure class

Background: "must not be empty", "cannot be empty" — required-field validation errors across open-source libraries — this error's family across 41 libraries.

Related errors

• app_id must not been empty
• LONG_CONTENT_MISS_FILE_INFO
• LONG_CONTENT_MISS_FILE_INFO
• PARAM_ERROR
• 21600

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

Appendix: source

Thrown at console/backend/toolkit/src/main/java/com/iflytek/astron/console/toolkit/controller/tool/ToolBoxController.java:34

import java.util.List;
import java.util.Map;

@RestController
@RequestMapping("/tool")
@Slf4j
@ResponseResultBody
@Tag(name = "Plugin Management")
public class ToolBoxController {
    @Resource
    ToolBoxService toolBoxService;

    @PostMapping("/create-tool")
    @Operation(summary = "Create plugin")
    @SpacePreAuth(key = "ToolBoxController_createTool_POST")
    public Object createTool(@RequestBody ToolBoxDto toolBoxDto) {
        if (toolBoxDto.getName() == null) {
            throw new BusinessException(ResponseEnum.TOOLBOX_NAME_EMPTY);
        }
        if (toolBoxDto.getDescription() == null) {
            throw new BusinessException(ResponseEnum.TOOLBOX_NAME_EMPTY);
        }
        return toolBoxService.createTool(toolBoxDto);
    }

    @PostMapping("/temporary-tool")
    @Operation(summary = "Temporarily save plugin")
    @SpacePreAuth(key = "ToolBoxController_temporaryTool_POST")
    public Object temporaryTool(@RequestBody ToolBoxDto toolBoxDto) {
        if (toolBoxDto.getName() == null) {
            throw new BusinessException(ResponseEnum.TOOLBOX_NAME_EMPTY);
        }
        return toolBoxService.temporaryTool(toolBoxDto);
    }

    @PutMapping("/update-tool")

View on GitHub (pinned to 5e758547a8)