apache/seatunnel · error · IllegalArgumentException

Invalid Deep Lake workspace

Error message

Invalid Deep Lake workspace

What it means

DeepLakeClient percent-encodes the workspace name as a URL path segment using URLEncoder.encode with UTF-8. If the encode call throws, the client wraps it in an IllegalArgumentException('Invalid Deep Lake workspace'). It signals the workspace value could not be safely encoded for the Deep Lake REST URL.

Solutions

1. Ensure the JVM supports the UTF-8 charset (standard JDK 8+ does); rebuild/replace any stripped runtime
2. Verify no agent or ClassLoader is shadowing java.nio.charset implementations
3. Update the connector/runtime; on modern JDKs this path is effectively dead code

if (workspace == null || workspace.trim().isEmpty()) { throw new IllegalArgumentException("workspace must not be blank"); }

boolean isValidWorkspace(String ws) { return ws != null && !ws.trim().isEmpty(); }

try { client.workspace(ws); } catch (IllegalArgumentException e) { log.error("workspace encoding failed", e); throw e; }

When it happens

Trigger: Any call to DeepLakeClient.workspace(...) when URLEncoder.encode(value, 'UTF-8') fails. Nearly unreachable on standard JVMs since UTF-8 is always available; can surface on exotic or broken runtimes/charsets.

Common situations: Running on a stripped-down JVM image without the UTF-8 charset provider (minimal containers), custom runtime environments, or setups where charset lookup via StandardCharsets.UTF_8.name() fails.

Understand the failure class

Background: "Invalid URL" errors: why new URL(), URI.parse, and reqwest::Url reject your string — missing scheme, whitespace, and bad path format — this error's family across 39 libraries.

Related errors

• GET /overview slow: costMs=
• GET /running-jobs slow diagnostics: full=
• must be greater than zero
• must not be blank
• RABBITMQ-09

AI-assisted analysis of apache/seatunnel@cf67b549a7 (2026-09-10). Data as JSON: /api/errors/2531a01cad280b6f. Report an issue: GitHub.

Appendix: source

Thrown at seatunnel-connectors-v2/connector-deeplake/src/main/java/org/apache/seatunnel/connectors/seatunnel/deeplake/client/DeepLakeClient.java:110

                            : EntityUtils.toString(response.getEntity(), StandardCharsets.UTF_8);
            if (status < 200 || status >= 300) {
                throw new DeepLakeConnectorException(
                        DeepLakeConnectorErrorCode.REQUEST_FAILED,
                        "Deep Lake request failed with HTTP "
                                + status
                                + (responseBody.isEmpty() ? "" : ": " + responseBody));
            }
        } catch (IOException e) {
            throw new DeepLakeConnectorException(
                    DeepLakeConnectorErrorCode.REQUEST_FAILED, "Deep Lake request failed", e);
        }
    }

    private static String encodePathSegment(String value) {
        try {
            return URLEncoder.encode(value, StandardCharsets.UTF_8.name()).replace("+", "%20");
        } catch (Exception e) {
            throw new IllegalArgumentException("Invalid Deep Lake workspace", e);
        }
    }

    @Override
    public void close() throws IOException {
        httpClient.close();
    }
}

View on GitHub (pinned to cf67b549a7)