Swift项目添加GitHub包遇重复错误，求MariaDB连接解决方案

先聊聊你遇到的包添加错误问题，大概率是这几个常见原因导致的，你可以逐个排查试试：

一、修复包添加失败的常见方案 #

• 检查包地址与版本：确认你添加的mariadb-connector-c包URL没有多余字符，或者试试指定一个稳定的已发布版本（而非默认的main分支），很多时候分支代码不稳定会导致编译失败。
• 清理SwiftPM缓存：缓存损坏是Swift包管理的常见坑，终端执行rm -rf ~/Library/Caches/org.swift.swiftpm，然后重启Xcode再重新添加包。
• 验证Xcode版本兼容性：有些包对Xcode版本有要求，比如需要Xcode 14及以上，确认你的Xcode版本符合包的最低要求。
• 安装系统底层依赖：mariadb-connector-c依赖系统级的MariaDB驱动库，macOS下可以用Homebrew安装：brew install mariadb-connector-c，之后再尝试添加包。
• 查看详细错误日志：Xcode的包管理器输出可能不够详细，进入项目目录，终端运行swift package update，能看到完整的编译错误信息，帮你精准定位问题。

二、替代的MariaDB连接方案 #

如果Perfect的方案始终走不通，推荐几个维护活跃、易用的Swift库：

1. MySQLNIO（异步高性能） #

这是Vapor生态下的异步MySQL/MariaDB客户端，基于SwiftNIO开发，性能出色，对MariaDB兼容性很好。简单使用示例：

import MySQLNIO
import NIO

let config = MySQLConfiguration(
    hostname: "你的数据库地址",
    port: 3306,
    username: "用户名",
    password: "密码",
    database: "目标数据库名"
)

let eventLoopGroup = MultiThreadedEventLoopGroup(numberOfThreads: System.coreCount)
defer { try? eventLoopGroup.syncShutdownGracefully() }

// 建立连接
let client = try MySQLConnection.connect(configuration: config, on: eventLoopGroup.next()).wait()
defer { try? client.close().wait() }

// 执行查询
let rows = try client.query("SELECT * FROM your_table").wait()
for row in rows {
    if let id = row.column("id")?.int, let name = row.column("name")?.string {
        print("ID: \(id), Name: \(name)")
    }
}

2. FluentMySQL（ORM层简化开发） #

如果你的项目用Vapor框架，FluentMySQL提供了完整的ORM功能，能让你用Swift模型来操作数据库，省去直接写SQL的麻烦，底层基于MySQLNIO，对MariaDB支持良好。

3. MariaDBConnector（原生驱动封装） #

还有一个专门针对MariaDB的Swift包，直接封装了原生驱动，配置简单，适合轻量级项目使用，你可以在Swift Package Manager中直接添加它的依赖。

三、额外建议 #

如果是做iOS/macOS应用，注意App Sandbox权限：如果是macOS应用，需要在项目设置中开启“Outgoing Connections (Client)”权限，否则应用无法连接远程数据库。

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