apache/dolphinscheduler · error · IllegalArgumentException

dateStr: [

Error message

dateStr: [

What it means

Thrown in transformDate when DateUtils.stringToDate cannot convert the given dateStr into a Date (returns null). It is a parse-failure guard: the caller passed a date string that is not in a recognized format, so the API layer rejects it as an invalid request parameter.

Source

Thrown at dolphinscheduler-api/src/main/java/org/apache/dolphinscheduler/api/service/impl/BaseServiceImpl.java:138

        if (!StringUtils.isEmpty(startDateStr)) {
            start = DateUtils.stringToDate(startDateStr);
            if (Objects.isNull(start)) {
                log.warn("Parameter startDateStr is invalid.");
                throw new ServiceException(Status.REQUEST_PARAMS_NOT_VALID_ERROR, Constants.START_END_DATE);
            }
        }
        return start;
    }

    @Override
    public boolean checkDescriptionLength(String description) {
        return description != null && description.codePointCount(0, description.length()) > 255;
    }

    protected Date transformDate(String dateStr) {
        Date date = DateUtils.stringToDate(dateStr);
        if (date == null) {
            throw new IllegalArgumentException("dateStr: [" + dateStr + "] is invalid");
        }
        return date;
    }
}

View on GitHub (pinned to 02eac45a1b)

Solutions

1. Pass the date string in the format DolphinScheduler expects, e.g. yyyy-MM-dd HH:mm:ss.
2. Validate/normalize the date input on the client before sending the request.
3. Check for timezone suffixes or locale-specific formats that the parser cannot handle.

When it happens

Trigger: Thrown at dolphinscheduler-api/src/main/java/org/apache/dolphinscheduler/api/service/impl/BaseServiceImpl.java:138 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of apache/dolphinscheduler@02eac45a1b (2026-09-06). Data as JSON: /api/errors/ff7958d90df7b9f4. Report an issue: GitHub.