Linux下Swift项目引入SQLite.swift时出现多CSQLite目标冲突问题

问题背景 #

开发一个读取SQLite文件的Swift实验项目，同时使用SQLite.swift库和Vapor的fluent-sqlite-driver。项目在macOS Ventura的Xcode/SPM环境下可正常构建运行，但在Raspberry Pi OS上构建时触发报错：

csqlite和sqlite-nio中存在多个名为CSQLite的目标，建议使用moduleAliases参数设置唯一名称

排查后发现：SQLite.swift在Linux环境下依赖stephencelis维护的CSQLite仓库，而fluent-sqlite-driver依赖的sqlite-nio则引入了vapor维护的同名CSQLite模块，二者在构建时产生命名冲突。尝试单独为SQLite模块设置moduleAliases将CSQLite重命名为BSQLite后，要么冲突仍未消除，要么SQLite.swift源码找不到CSQLite模块。

解决方案 #

要彻底解决冲突，需在顶层Package.swift中同时针对两个不同来源的CSQLite模块设置别名，确保各自依赖链能正确识别重命名后的模块：

方案1：通过packageAliases全局区分仓库 #

在Package定义中添加packageAliases，根据两个CSQLite的仓库URL设置不同别名：

let package = Package(
    name: "YourProjectName",
    dependencies: [
        .package(url: "https://github.com/stephencelis/SQLite.swift.git", from: "0.14.1"),
        .package(url: "https://github.com/vapor/fluent-sqlite-driver.git", from: "4.0.0")
    ],
    targets: [
        .executableTarget(
            name: "YourExecutable",
            dependencies: [
                .product(name: "SQLite", package: "SQLite.swift"),
                .product(name: "FluentSQLiteDriver", package: "fluent-sqlite-driver")
            ]
        ),
        .testTarget(
            name: "YourProjectTests",
            dependencies: ["YourExecutable"]
        )
    ],
    packageAliases: [
        // 为SQLite.swift依赖的CSQLite设置别名
        .package(name: "CSQLite", url: "https://github.com/stephencelis/CSQLite.git", alias: "SQLiteCSQLite"),
        // 为sqlite-nio依赖的CSQLite设置别名
        .package(name: "CSQLite", url: "https://github.com/vapor/CSQLite.git", alias: "VaporCSQLite")
    ]
)

方案2：在目标依赖中单独设置moduleAliases #

如果全局别名不生效，可在具体的target依赖中针对每个产物单独配置模块别名：

let package = Package(
    name: "YourProjectName",
    dependencies: [
        .package(url: "https://github.com/stephencelis/SQLite.swift.git", from: "0.14.1"),
        .package(url: "https://github.com/vapor/fluent-sqlite-driver.git", from: "4.0.0")
    ],
    targets: [
        .executableTarget(
            name: "YourExecutable",
            dependencies: [
                .product(name: "SQLite", package: "SQLite.swift", moduleAliases: [
                    "CSQLite": "SQLiteCSQLite"
                ]),
                .product(name: "FluentSQLiteDriver", package: "fluent-sqlite-driver", moduleAliases: [
                    "CSQLite": "VaporCSQLite"
                ])
            ]
        ),
        .testTarget(
            name: "YourProjectTests",
            dependencies: ["YourExecutable"]
        )
    ]
)

关键注意点 #

• 两个CSQLite属于不同仓库：SQLite.swift用的是stephencelis版本，sqlite-nio用的是vapor版本，必须通过仓库URL区分设置别名，不能仅靠包名。
• 必须同时处理两个来源的CSQLite，只改其中一个会导致冲突残留或模块找不到的问题。
• 设置别名后无需修改SQLite.swift或sqlite-nio的源码，SPM会自动处理依赖链中的模块引用映射。

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