Odoo Python Version Mismatch — 'SyntaxError' and 'ModuleNotFoundError' Fix

Python Version Mismatch Errors in Odoo

Odoo 17+ requires Python 3.10 or higher. Odoo 19 specifically needs Python 3.12+. Running Odoo with an older Python version produces cryptic errors that do not immediately point to the version problem:

SyntaxError: invalid syntax
  File "/opt/odoo/odoo/tools/misc.py", line 42
    match value:
          ^^^^^
SyntaxError: invalid syntax

This happens because Python's match statement was introduced in Python 3.10. You may also see:

ModuleNotFoundError: No module named 'tomllib'
ModuleNotFoundError: No module named 'importlib.metadata'

Diagnosing the Problem

First, check which Python version Odoo is actually using:

# Check default Python
python3 --version

# Check all installed Python versions
ls /usr/bin/python3*

# If using a venv, check the venv Python
/opt/odoo/venv/bin/python --version

# Check which python the odoo service uses
systemctl cat odoo | grep ExecStart

Common scenarios where version mismatch occurs:

• Ubuntu 20.04 ships Python 3.8, but Odoo 19 needs 3.12
• Ubuntu 22.04 ships Python 3.10, sufficient for Odoo 17 but not Odoo 19
• The virtual environment was created with an old Python, then Odoo was upgraded
• Multiple Python versions exist and the wrong one is being invoked

Fix 1: Install the Correct Python Version

On Ubuntu 22.04/24.04:

# Add deadsnakes PPA for newer Python versions
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update

# Install Python 3.12
sudo apt install python3.12 python3.12-venv python3.12-dev

# Verify
python3.12 --version

On Ubuntu 20.04:

# Same PPA approach
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
sudo apt install python3.12 python3.12-venv python3.12-dev python3.12-distutils

Fix 2: Recreate the Virtual Environment

After installing the correct Python, recreate the venv:

# Remove old venv
rm -rf /opt/odoo/venv

# Create new venv with correct Python
python3.12 -m venv /opt/odoo/venv

# Activate and install
source /opt/odoo/venv/bin/activate
pip install --upgrade pip setuptools wheel
pip install -r /opt/odoo/odoo/requirements.txt

Fix 3: Update the Systemd Service File

Ensure the Odoo service uses the correct Python:

# Edit the service file
sudo systemctl edit odoo --full

# Change ExecStart to use the venv Python:
[Service]
ExecStart=/opt/odoo/venv/bin/python /opt/odoo/odoo/odoo-bin -c /etc/odoo.conf

# Reload and restart
sudo systemctl daemon-reload
sudo systemctl restart odoo

Fix 4: Docker — Use the Right Base Image

If running Odoo in Docker, ensure the Dockerfile uses a compatible base:

# Wrong — Python 3.8
FROM python:3.8-slim

# Correct for Odoo 19
FROM python:3.12-slim

# Or use the official Odoo image which bundles the right Python
FROM odoo:19

Version Compatibility Table

Common Symptoms by Wrong Python Version

Prevention

DeployMonkey provisions every Odoo instance with the exact Python version required. The platform validates version compatibility during deployment and automatically handles virtual environment creation. No version mismatch possible.