{"record":{"id":"43239eacbedc689c","repo":"elastic/elasticsearch","slug":"setting-separator-must-be-a-single-non-null-cha","errorCode":null,"errorMessage":"Setting [separator] must be a single, non-null character. [{}] was provided.","messagePattern":"Setting \\[separator\\] must be a single, non-null character\\. \\[(.+?)\\] was provided\\.","errorType":"validation","errorClass":"IllegalArgumentException","httpStatus":null,"severity":"error","filePath":"modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/FingerprintAnalyzerProvider.java","lineNumber":59,"sourceCode":"        CharArraySet stopWords = Analysis.parseStopWords(env, settings, DEFAULT_STOP_WORDS);\n\n        this.analyzer = new FingerprintAnalyzer(stopWords, separator, maxOutputSize);\n    }\n\n    @Override\n    public FingerprintAnalyzer get() {\n        return analyzer;\n    }\n\n    public static char parseSeparator(Settings settings) throws IllegalArgumentException {\n        String customSeparator = settings.get(SEPARATOR.getPreferredName());\n        if (customSeparator == null) {\n            return DEFAULT_SEPARATOR;\n        } else if (customSeparator.length() == 1) {\n            return customSeparator.charAt(0);\n        }\n\n        throw new IllegalArgumentException(\n            \"Setting [separator] must be a single, non-null character. [\" + customSeparator + \"] was provided.\"\n        );\n    }\n}\n","sourceCodeStart":41,"sourceCodeEnd":64,"githubUrl":"https://github.com/elastic/elasticsearch/blob/db6a809a667c081ca1dc7500389d26975573215f/modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/FingerprintAnalyzerProvider.java#L41-L64","documentation":"Error \"Setting [separator] must be a single, non-null character. [{}] was provided.\" thrown in elastic/elasticsearch.","triggerScenarios":"Thrown at modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/FingerprintAnalyzerProvider.java:59 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":[],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"db6a809a667c081ca1dc7500389d26975573215f","analyzedAt":"2026-08-12T01:39:14.192Z","schemaVersion":2},"datasetVersion":"2026-08-12T12:31:55.035Z"}