Excalidraw本地部署时遇到数据库连接失败如何解决？

Question

在本地部署Excalidraw时，如果遇到数据库连接失败的问题，通常是因为数据库配置错误或网络问题。首先，确认数据库服务是否已启动并正常运行，检查数据库端口（如默认的3306或5432）是否被防火墙阻止。其次，核实`excalidraw.config.js`文件中的数据库连接字符串是否正确，包括主机名、端口、用户名和密码等信息。如果使用的是MySQL或PostgreSQL，确保数据库用户具有足够的权限访问指定数据库。此外，尝试通过命令行工具直接连接数据库，以排除其他干扰因素。最后，查看Excalidraw服务器日志，定位具体的错误信息，从而进一步分析和解决问题。确保所有依赖项版本兼容也是关键步骤之一。

Answer 1

1. 确认数据库服务状态

在本地部署 Excalidraw 时，如果遇到数据库连接失败的问题，首要任务是确认数据库服务是否正常运行。以下步骤可以帮助你排查问题：

• 检查数据库服务是否已启动。可以通过命令行工具或管理界面验证。
• 确保数据库端口（如 MySQL 的 3306 或 PostgreSQL 的 5432）未被防火墙阻止。
• 使用 `netstat` 或 `ss` 命令查看端口监听情况，例如：

netstat -an | grep 3306
    

如果端口未监听，可能是数据库服务未正确启动或配置错误。

2. 核实数据库连接字符串

接下来，检查 `excalidraw.config.js` 文件中的数据库连接字符串是否正确。以下是需要关注的关键点：

参数	描述	示例值
主机名	数据库服务器的 IP 地址或域名	localhost 或 192.168.1.10
端口	数据库服务的监听端口	3306 (MySQL) 或 5432 (PostgreSQL)
用户名	用于访问数据库的用户	root 或 excalidraw_user
密码	用户的登录密码	password123

确保所有字段与实际数据库配置一致。

3. 数据库用户权限检查

如果使用的是 MySQL 或 PostgreSQL，必须确保数据库用户具有足够的权限访问指定数据库。例如，在 MySQL 中可以执行以下命令授予权限：

GRANT ALL PRIVILEGES ON excalidraw_db.* TO 'excalidraw_user'@'localhost' IDENTIFIED BY 'password123';
FLUSH PRIVILEGES;
    

对于 PostgreSQL，可以使用以下命令：

CREATE USER excalidraw_user WITH PASSWORD 'password123';
GRANT ALL PRIVILEGES ON DATABASE excalidraw_db TO excalidraw_user;
    

确保权限设置符合实际需求。

4. 使用命令行工具测试连接

为了排除其他干扰因素，建议通过命令行工具直接测试数据库连接。例如，对于 MySQL：

mysql -u excalidraw_user -p -h localhost -P 3306
    

对于 PostgreSQL：

psql -U excalidraw_user -d excalidraw_db -h localhost -p 5432
    

如果连接成功，说明问题可能出在应用程序配置上。

5. 查看服务器日志定位问题

Excalidraw 服务器日志通常会记录详细的错误信息，帮助快速定位问题。可以通过以下步骤分析：

1. 找到日志文件位置，通常在 `logs/` 目录下。
2. 搜索关键字如 "database connection failed" 或具体的错误代码。
3. 结合日志内容和之前的排查步骤，进一步缩小问题范围。

例如，日志中可能会显示：

Error: connect ECONNREFUSED 127.0.0.1:3306
    

6. 检查依赖项版本兼容性

最后，确保所有依赖项版本兼容。可以通过以下流程图了解版本检查的逻辑：

graph TD;
            A[开始] --> B{检查 Node.js 版本};
            B --不兼容--> C[升级 Node.js];
            B --兼容--> D{检查数据库驱动版本};
            D --不兼容--> E[更新驱动];
            D --兼容--> F[完成];

例如，确保使用的 MySQL 或 PostgreSQL 驱动版本与数据库版本匹配。