BarTender 数据库连接失败排查指南
批量打印需要连数据库。但经常遇到”连不上”的问题——Excel 连不上、SQL 连不上、CSV 读不了。
这篇指南按从简单到复杂的顺序，列出常见原因和解决方法。
一、先确认你连的是什么数据库
BarTender 支持很多种数据源：
- Excel 文件（.xlsx, .xls）
- CSV 文件
- SQL Server
- MySQL
- Oracle
- Access
- 文本文件
不同的数据源，排查方法不一样。先搞清楚你连的是哪种。
关于支持的数据源列表，可以看：BarTender 支持哪些数据源。
二、Excel 连不上
原因 1：Excel 文件被占用
你在 Excel 里打开了这个文件，BarTender 就读不了。
解决：关掉 Excel，再试连接。
原因 2：文件路径有中文或空格
BarTender 对中文路径支持不好。
解决：把 Excel 文件放到纯英文路径下，比如 D:\data\products.xlsx。
原因 3：Excel 版本不对
.xlsx 格式需要装 ACE 驱动。如果是老版本 Office，可能只有 .xls。
解决：装 Microsoft Access Database Engine 驱动。
原因 4：工作表选错了
Excel 里有多个工作表，你选的那个表是空的。
解决：连接的时候选对工作表。
关于 Excel 连接的详细教程，可以看：BarTender 连接 Excel 打印标签。
三、SQL Server 连不上
原因 1：服务器地址不对
服务器名或 IP 地址输错了。
解决：确认 SQL Server 的地址和端口。默认端口是 1433。
原因 2：登录账号密码不对
用户名或密码错了。
解决：用 SSMS 或 Navicat 试试能不能登录，确认账号密码。
原因 3：SQL Server 没开远程连接
SQL Server 默认可能只允许本地连接。
解决：在 SQL Server 配置管理器里开启远程连接，开 TCP/IP 协议。
原因 4：防火墙挡了
Windows 防火墙或网络防火墙挡了 1433 端口。
解决：在防火墙上开 1433 端口。
原因 5：驱动没装
BarTender 用的是 ODBC/OLE DB 驱动。如果没装对应驱动，连不上。
解决：装 SQL Server Native Client 或 ODBC Driver。
四、CSV 读不了
原因 1：编码不对
CSV 文件是 GBK 编码，BarTender 按 UTF-8 读，中文就乱码了。
解决：把 CSV 文件另存为 UTF-8 编码。
原因 2：分隔符不对
CSV 默认用逗号分隔，但你的文件用的是分号或 Tab。
解决：连接的时候选对分隔符。
原因 3：第一行不是列名
CSV 第一行是数据，不是列名。BarTender 会把第一行当列名，就不对了。
解决：确认 CSV 第一行是列名。
五、通用排查步骤
如果不知道是什么问题，按这个顺序排查：
- 先确认文件路径对不对 — 文件是不是真的在那个位置
- 再确认文件没被占用 — 关掉 Excel 再试
- 然后确认权限 — 当前用户有没有读这个文件的权限
- 最后用记事本打开看看 — 文件格式对不对，有没有乱码
六、常见错误代码
| 错误代码/提示 | 原因 | 解决 |
|---|---|---|
| 找不到文件 | 路径错了 | 检查文件路径 |
| 未找到提供程序 | 驱动没装 | 装对应 ODBC 驱动 |
| 登录失败 | 账号密码错 | 确认 SQL 账号密码 |
| 网络错误 | 连不上服务器 | 检查网络和防火墙 |
相关阅读
还是连不上？
如果以上都排查过了还是连不上，可以联系我们的技术支持。我们远程帮你看连接配置和驱动问题。