ParseException — Cannot Parse Query Syntax Error in Solr Search

Here's an actual broken query from a real Solr log:

The application code was supposed to send two separate things: a query q=ss_bundle:url_builder and a filter fq=ss_bundle:toc. But due to a bug, they got glued together into one broken string.

The error message tells you exactly where it broke. Let's decode it:

Fix 1 — Properly Separate Query Parameters

If your query and filter query got concatenated, they need to be separate URL parameters:

// WRONG — parameters mashed together
/solr/myindex/select?q=ss_bundle:url_builderORfq=ss_bundle:toc

// CORRECT — separate q and fq parameters with &
/solr/myindex/select?q=ss_bundle:url_builder&fq=ss_bundle:toc

Fix 2 — Add Spaces Around Boolean Operators

// WRONG — no spaces around OR
q=title:helloORtitle:world

// CORRECT — spaces around OR
q=title:hello OR title:world

Fix 3 — Escape Special Characters in User Input

If your users type search terms that contain colons, parentheses, or other special characters, you must escape them before sending to Solr:

// Special characters that need escaping in Solr queries:
// + - && || ! ( ) { } [ ] ^ " ~ * ? : \ /

// PHP example — escape user input:
$userQuery = preg_replace(
    '/([+\-!(){}\[\]^"~*?:\\\\/]|&&|\|\|)/',
    '\\\\$1',
    $userQuery
);

# Python example:
import re
user_query = re.sub(r'([+\-!(){}\[\]^"~*?:\\/]|&&|\|\|)', r'\\\1', user_query)

Fix 4 — Balance Your Parentheses and Quotes

// WRONG — unclosed parenthesis
q=(title:hello OR title:world

// CORRECT — balanced parentheses
q=(title:hello OR title:world)

// WRONG — unclosed quote
q=title:"hello world

// CORRECT — balanced quotes
q=title:"hello world"