使用Poco库创建SQLite文件数据库遇FileNotFound错误的解决方法

排查步骤 #

• 确认路径类型：你代码里用的"var/opt"是相对路径，程序运行时会以当前工作目录为基准拼接路径，比如程序在/home/user/app下运行，实际路径会是/home/user/app/var/opt/...，而非系统根目录下的/var/opt。先把路径改成绝对路径"/var/opt"再测试。
• 检查父目录是否存在：POCO的SQLite Session不会自动创建数据库文件的父目录，如果data_dir_path对应的目录不存在，直接创建数据库会触发FileNotFound错误。可以手动用mkdir -p /var/opt/agent/data/module创建目录，或者在代码里自动创建。
• 验证权限的实际覆盖范围：确保从根目录到module的每一层目录都给了当前用户执行权限（Linux下进入目录需要执行权限），以及module目录的写入权限。可以用命令ls -ld /var/opt /var/opt/agent /var/opt/agent/data /var/opt/agent/data/module逐层检查权限。
• 打印实际路径验证：在代码中添加绝对路径输出，确认程序实际访问的路径是否符合预期：

  std::cout << "实际数据库路径: " << std::filesystem::absolute(database_file) << std::endl;
  

正确代码示例 #

以下代码包含目录自动创建、绝对路径使用和基础错误处理，确保数据库文件能正常创建：

#include <Poco/Data/SQLite/SQLite.h>
#include <Poco/Data/Session.h>
#include <Poco/SharedPtr.h>
#include <filesystem>
#include <iostream>

int main() {
    // 使用绝对路径，避免工作目录影响
    std::filesystem::path data_root_path("/var/opt");
    auto data_dir_path = data_root_path / "agent" / "data" / "module";
    auto database_file = data_dir_path / "database.db";

    try {
        // 递归创建所有不存在的父目录
        if (!std::filesystem::exists(data_dir_path)) {
            std::filesystem::create_directories(data_dir_path);
            std::cout << "目录已创建: " << data_dir_path << std::endl;
        }

        // 注册SQLite连接器
        Poco::Data::SQLite::Connector::registerConnector();

        // 创建数据库会话（不存在则自动创建文件）
        Poco::SharedPtr<Poco::Data::Session> database_ = 
            Poco::makeShared<Poco::Data::Session>("SQLite", database_file.string());
        
        std::cout << "数据库会话创建成功" << std::endl;

        // 后续数据库操作...

    } catch (const std::exception& e) {
        std::cerr << "错误: " << e.what() << std::endl;
        return 1;
    }

    return 0;
}

额外说明 #

• POCO的SQLite Session在指定的数据库文件不存在时，会自动创建文件，但前提是父目录存在且有写入权限。
• 若仍有权限问题，可临时用chmod 777 /var/opt/agent/data/module测试（仅限调试，生产环境需设置最小必要权限），确认是否为权限问题。

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