Dorisoy.Pan 数据库配置完全指南MySQL 8.0 与 SQL Server 2012 双库无缝切换【免费下载链接】Dorisoy.PanDorisoy.Pan 是基于 .NET 10 的跨平台文档管理系统使用 MS SQL 2012 / MySQL 8.0或更高版本后端数据库您可以在 Windows、Linux 或 Mac 上运行它。项目中的所有方法都是异步的支持 JWT 令牌身份验证项目体系结构遵循 CQRS MediatR 模式和最佳安全实践。源代码完全可定制热插拔且清晰的体系结构使开发定制功能和遵循任何业务需求变得容易。项目地址: https://gitcode.com/gh_mirrors/do/Dorisoy.PanDorisoy.Pan 是基于 .NET 10 的跨平台文档管理系统其数据库配置是整个部署环节中至关重要的一步。本指南将带你逐步完成 Dorisoy.Pan 的 MySQL 8.0 数据库配置与 SQL Server 2012 双库无缝切换从连接字符串设置、数据库初始化到常见问题排查无论你是新手还是运维老手都能按图索骥、一次跑通。Dorisoy.Pan 支持哪些数据库先了解你的选择在动手配置之前先明确 Dorisoy.Pan 官方支持的数据库类型数据库版本要求驱动MySQL8.0 或更高版本MySql.EntityFrameworkCore 10.0.1Oracle 官方驱动SQL Server2012 或更高版本Microsoft.EntityFrameworkCore.SqlServer 10.0.3SQLite本地轻量测试内置脚本支持也就是说你可以根据服务器环境自由选择 MySQL 8.0 或 SQL Server 2012两套方案在 Dorisoy.Pan 中切换只需要改动一处连接字符串这正是双库无缝切换的精髓所在。小提示Redis 是可选依赖仅用于文件上传并发锁控制。未安装 Redis 时系统会自动降级为无锁模式不影响核心功能。数据库配置前的准备工作清单开始配置前请确认以下环境已就绪已安装 MySQL 8.0 或 SQL Server 2012并创建好专用数据库账号建议使用独立账号避免使用 root 等高权限账号已安装 .NET 10 SDK后端 API 运行环境已获取项目源码整体目录结构如下Web/Dorisoy.Pan.API # API 主项目数据库配置入口 Web/Dorisoy.Pan.Domain # EF Core DbContext 与数据库迁移 SQL/ # 数据库初始化脚本最快捷的 MySQL 8.0 连接字符串配置方法Dorisoy.Pan 的数据库连接配置集中在Web/Dorisoy.Pan.API/appsettings.json文件中。找到connectionStrings节点将DocumentDbConnectionString修改为你自己的 MySQL 8.0 连接信息connectionStrings: { DocumentDbConnectionString: server你的MySQL地址;Port3306;user用户名;password密码;databasedorisoy_pan;Allow User VariablesTrue, Redis: 127.0.0.1:6379 }字段含义说明serverMySQL 服务器地址本机可用localhost或127.0.0.1PortMySQL 端口默认 3306user/password数据库账号与密码database数据库名建议命名为dorisoy_panAllow User VariablesTrueDorisoy.Pan 运行所必需的参数务必保留API 启动时会读取该配置并调用 EF Core 的UseMySQL方法完成上下文注册对应代码位于Web/Dorisoy.Pan.API/Startup.cs中的AddDbContextPoolDocumentContext注册处。SQL Server 2012 连接字符串配置与双库无缝切换如果你更倾向于使用 SQL Server 2012切换方式同样简单把DocumentDbConnectionString替换为 SQL Server 格式的连接字符串即可connectionStrings: { DocumentDbConnectionString: Server你的SQLServer地址;Databasedorisoy_pan;User Idsa;Password你的密码;TrustServerCertificateTrue, Redis: 127.0.0.1:6379 }双库无缝切换的完整步骤停止 API 服务在Web/Dorisoy.Pan.API/appsettings.json中替换DocumentDbConnectionString的值用对应数据库的初始化脚本初始化数据见下文重启 API 服务系统自动切换到新数据库整个过程只需改动一个配置项业务代码完全无需修改这就是 CQRS 仓储架构带来的便利。数据库初始化两种方式任选其一配置好连接字符串后需要初始化数据库结构。Dorisoy.Pan 提供两种方式方式一使用 EF Core Migration 自动建库在 Visual Studio 的 Package Manager Console 中执行默认项目选择Dorisoy.Pan.DomainUpdate-Database方式二直接执行官方 SQL 脚本项目SQL/目录下提供了完整的初始化脚本MySQL执行SQL/MySQL.sql存储过程另见SQL/PROCEDURE-MySQL.sqlSQL Server执行SQL/MsSQL.sqlSQLite执行SQL/SQLite.sqlDorisoy.Pan 文档管理系统的文件管理与数据库驱动界面.png)启动 API 服务并验证数据库配置数据库初始化完成后在项目根目录执行以下命令启动 APIdotnet run --project Web/Dorisoy.Pan.API启动成功后默认会打开 Swagger 文档页你可以调用登录接口验证用户数据是否正常读写默认管理员账号见项目 README上传一个测试文件验证文件元数据是否正确写入数据库观察日志输出确认没有数据库连接异常数据库配置常见问题排查速查表问题现象可能原因解决方案启动报数据库连接超时连接字符串地址或端口错误检查server与Port是否与数据库实例一致提示 Access denied账号权限不足为账号授予目标数据库的全部权限Allow User Variables相关报错连接字符串缺少必要参数补上Allow User VariablesTrue中文字符乱码数据库字符集不是 utf8mb4建库时指定utf8mb4字符集切换数据库后数据为空未执行对应数据库的初始化脚本重新执行SQL/下对应脚本结语Dorisoy.Pan 的数据库配置并不复杂核心就是改一处连接字符串 执行一次初始化脚本。通过本文你已经掌握了 MySQL 8.0 与 SQL Server 2012 双库无缝切换的完整流程。无论你最终选择哪种数据库这套配置方法都能让你的文档管理系统在 Windows、Linux 或 Mac 上稳定运行享受 JWT 身份认证与全异步架构带来的流畅体验。遇到问题欢迎对照速查表逐项排查。【免费下载链接】Dorisoy.PanDorisoy.Pan 是基于 .NET 10 的跨平台文档管理系统使用 MS SQL 2012 / MySQL 8.0或更高版本后端数据库您可以在 Windows、Linux 或 Mac 上运行它。项目中的所有方法都是异步的支持 JWT 令牌身份验证项目体系结构遵循 CQRS MediatR 模式和最佳安全实践。源代码完全可定制热插拔且清晰的体系结构使开发定制功能和遵循任何业务需求变得容易。项目地址: https://gitcode.com/gh_mirrors/do/Dorisoy.Pan创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考