解决pyodbc连接Access数据库时"Not a valid file name"错误

在使用pyodbc连接Microsoft Access数据库文件(.mdb)时，开发者可能会遇到"Not a valid file name"(-1044)错误。这个问题通常出现在Windows环境下，特别是当使用相对路径指定数据库文件时。

问题现象

当尝试使用如下连接字符串连接Access数据库时：

conn_string = r"DRIVER={Microsoft Access Driver (*.mdb, *.accdb)};DBQ=CD Collection.mdb"

系统会抛出错误：

pyodbc.Error: ('HY000', '[HY000] [Microsoft][ODBC Microsoft Access Driver] Not a valid file name. (-1044)')

问题原因

这个错误的发生与ODBC驱动处理相对路径的方式有关。Microsoft Access ODBC驱动在解析文件路径时，对相对路径的处理存在一定的限制，特别是在某些Windows版本和Python环境下。

解决方案

解决这个问题的最简单方法是在文件名前添加./前缀，将相对路径显式化：

conn_string = r"DRIVER={Microsoft Access Driver (*.mdb, *.accdb)};DBQ=./CD Collection.mdb"

其他可行的解决方案

1. 使用绝对路径：提供数据库文件的完整绝对路径是最可靠的方式

   conn_string = r"DRIVER={Microsoft Access Driver (*.mdb, *.accdb)};DBQ=C:\path\to\CD Collection.mdb"
   

2. 确保文件存在：验证文件确实存在于指定路径，并且Python进程有访问权限

3. 检查文件扩展名：确认文件扩展名确实是.mdb或.accdb，并且与驱动声明匹配

最佳实践建议

1. 在生产环境中，建议始终使用绝对路径来避免路径解析问题
2. 在代码中添加文件存在性检查
3. 考虑使用try-except块捕获并处理可能的连接错误
4. 对于大型Access数据库(如示例中的1GB文件)，连接时可能需要额外耐心

总结

"Not a valid file name"错误通常可以通过显式指定路径前缀或使用绝对路径来解决。理解ODBC驱动对路径处理的特殊性有助于开发者更高效地解决这类连接问题。对于Access数据库操作，路径规范性和文件访问权限是需要特别关注的两个方面。