使用pytest-mysql连接Docker中已有MySQL服务时出现“No such file or directory: mysqld”错误的排查求助

你遇到的核心问题是pytest-mysql默认的mysql fixture会自动尝试启动本地的mysqld进程——哪怕你已经配置了外部数据库的连接信息。这个fixture本质是mysql_proc（负责启动本地MySQL服务端）和mysql_client（负责连接数据库）的组合体，所以它会先尝试启动本地的mysqld，这就是为什么会出现FileNotFoundError: 'mysqld'——你的Python容器里只装了客户端依赖，根本没有MySQL服务端程序。

要连接你已经启动的外部MySQL容器，你需要直接使用pytest-mysql提供的**mysql_client fixture**（这个fixture只负责连接现有数据库，不会尝试启动本地服务），同时确保配置正确生效。

1. 修改测试用例使用正确的fixture #

把测试用例中原来依赖的mysql fixture替换成mysql_client：

# 错误用法（会触发本地mysqld启动逻辑）
def test_foo(mysql):
    pass

# 正确用法（仅连接外部已运行的MySQL实例）
def test_foo(mysql_client):
    # 使用mysql_client执行数据库操作
    cursor = mysql_client.cursor()
    cursor.execute("CREATE TABLE test (id INT)")
    # ... 你的测试逻辑代码

2. 确保pytest.ini配置被正确读取 #

你的pytest.ini配置项本身是对的，但要注意细节：

• 脚本里是在tests/目录下生成的pytest.ini，但测试是从项目根目录运行的，建议把生成的pytest.ini移动到项目根目录，确保pytest能正确加载配置
• 可以在测试中加一段代码验证配置是否生效：

  from pytest_mysql.config import get_config
  
  def test_config_validation(request):
      config = get_config(request)
      print(f"当前配置：host={config.host}, port={config.port}, user={config.user}")
      # 正常应该输出：host=db, port=3306, user=root
  

3. 验证Python容器与MySQL容器的连通性 #

在Python容器里手动测试连接，排除网络或账号权限问题：

# 进入Python容器后执行
apt-get install -y mysql-client
mysql -h db -P 3306 -u root -pSomepass123
# 如果能成功进入MySQL命令行，说明网络和账号配置都没问题

4. 可选：自定义外部数据库连接fixture #

如果不想依赖pytest-mysql的配置系统，也可以自己写一个简单的fixture来连接外部数据库：

import MySQLdb
import pytest

@pytest.fixture(scope="session")
def external_mysql_conn():
    # 直接连接外部MySQL容器
    conn = MySQLdb.connect(
        host="db",
        port=3306,
        user="root",
        passwd="Somepass123",
        db="TestDB"
    )
    # 确保测试数据库存在
    cursor = conn.cursor()
    cursor.execute("CREATE DATABASE IF NOT EXISTS TestDB")
    conn.select_db("TestDB")
    yield conn
    # 测试结束后关闭连接
    conn.close()

之后测试用例直接使用external_mysql_conn这个fixture即可。

• 检查requirements.txt里是否包含MySQL客户端库，比如mysqlclient（pytest-mysql依赖MySQLdb，而mysqlclient是MySQLdb的现代兼容版本）
• Docker的--link参数在新版本中已被推荐用自定义网络替代，你可以创建自定义网络来避免DNS解析问题：

  # 创建自定义网络
  docker network create test-network
  # 启动MySQL容器时加入网络
  container_id=$(docker run -d --network test-network --name mysql-db -e MYSQL_ROOT_PASSWORD=Somepass123 mysql:5.7)
  # 启动Python容器时加入同一网络，用容器名mysql-db作为host
  docker run -it --network test-network -v /Users/me/project:/srv -w /srv python:3.9-buster scripts/run-tests.sh Somepass123
  # 此时pytest.ini里的mysql_host要改成mysql-db
  

内容的提问来源于stack exchange，提问作者Banjer