YiShaAdmin部署避坑指南10分钟修好启动与连接问题【免费下载链接】YiShaAdmin基于 .NET Core MVC 的权限管理系统代码易读易懂、界面简洁美观项目地址: https://gitcode.com/GitHub_Trending/yi/YiShaAdmin大多数人卡在两处dotnet run一上来就报找不到运行时或者服务起来了、页面却不停闪数据库错误。YiShaAdmin 是一个基于 .NET Core MVC 的权限管理系统内置员工与部门管理、角色菜单权限、定时任务和代码生成适合用来快速搭 CMS、CRM、OA 这类管理后台。下面按症状把排查路径拆开10 分钟内能定位到问题。 部署前的 5 分钟自检SDK 与项目版本匹配——主项目 YiSha.Admin.Web 的目标框架是 netcoreapp3.1只装了 .NET 6/7 编译必挂。 验证dotnet --list-sdks全平台数据库服务可连通——MySQL 或 SQL Server 要在运行状态光装好还不够。 验证mysql -u root -p -e SELECT 1;Linux/macOSProvider 与数据库一致——DBProvider 默认是 SqlServer实际建了 MySQL 就必然连不上。 验证打开 YiSha.Web/YiSha.Admin.Web/appsettings.json看 SystemConfig 段端口空闲——Web 端默认占 5000WebApi 端默认占 5001。 验证netstat -ano | findstr :5000Windows依赖包已还原——克隆下来后要先还原一次 NuGet 包再编译。 验证dotnet restore全平台 按症状分组排查当 dotnet build 报找不到运行时时最可能的原因是机器 SDK 与项目目标框架不匹配YiSha.Admin.Web.csproj 里 TargetFramework 写的是 netcoreapp3.1只装了 .NET 6/7 就必然对不上另一种常见情况是 restore 那一步其实失败了被直接跳到了 build报错只是换了个说法。快速修复dotnet --list-sdks确认当前装了哪些版本。没有 3.1 就安装 .NET Core 3.1 SDK也可以把仓库切到 Net6 / Net7 分支与手上已有 SDK 对齐。先让dotnet restore跑成功再执行dotnet build。如果还没好查三处NuGet 源是否可达临时换个源再还原一次项目根目录有没有 global.json 锁定了没有装的版本解决方案里各 csproj 的 TargetFramework 是否同一大版本。当服务起来了但页面报数据库连接错误时最可能的原因是 appsettings.json 的 SystemConfig 里 DBProvider 与 DBConnectionString 两个字段不匹配默认配置连的是名为 YsData 的 SQL Server实际建了 MySQL或反过来连接必然失败。快速修复打开 Web 入口项目下的 appsettings.json把DBProvider改成MySql或SqlServer与真实数据库一致。连接串跟着 Provider 一起改MySQL 的最小配置长这样{ SystemConfig: { DBProvider: MySql, DBConnectionString: Serverlocalhost;Port3306;DatabaseYsData;Uidroot;Pwd你的密码; } }确认数据库初始化过数据库初始化脚本按 Provider 分成建表脚本和数据脚本脚本说明写得很清楚——先删表再建表别对着已有数据的库直接跑。连接修好后的首页左侧是菜单树中间展示框架介绍与技术选型如果还没好先用数据库客户端验证同一条连接串连不上就是数据库侧的问题再确认防火墙没拦 3306 或 1433报错若是超时而不是连不上看DBCommandTimeout默认 180 秒和慢查询。当登录成功但菜单为空、列表空白、定时任务不触发时最可能的原因是初始化数据没导全只跑了建表脚本没跑数据脚本菜单和角色表是空的或者管理员账户没挂上管理员角色。定时任务则要看任务本身的开关——Quartz.NET 调度下状态不是启用就不会写任何执行日志。快速修复用默认账户 admin / 123456 登录进系统管理 → 菜单管理确认菜单树是否完整。为空就重新导入对应 Provider 的数据脚本数据到位后在单位组织 → 员工管理里把管理员角色挂到账户上。进系统工具 → 定时任务确认任务启用开关打开、下次执行时间已生成任务调度实现在 定时任务模块。员工管理界面左侧是组织机构树右侧是员工列表可核对账户状态与角色归属如果还没好核对服务器系统时间是否正确调度完全依赖服务器时间手动验一遍 Cron 表达式Quartz 用 6~7 段和 5 段写法不一样打开自动任务执行日志看报错文本判断是任务代码本身的问题。⚙️ 把开发配置迁到生产环境缓存换成 Redis 怎么改SystemConfig 里只动两个字段{ SystemConfig: { CacheProvider: Redis, RedisConnectionString: 127.0.0.1:6379 } }Memory 缓存在进程重启后清空登录会话和菜单缓存会一并失效换 Redis 之后状态可持久多个应用实例还能共用一份缓存。连接串加上连接池{ SystemConfig: { DBConnectionString: Server10.0.0.5;DatabaseYsData;User Idsa;Passwordxxx;Poolingtrue;Min Pool Size5;Max Pool Size100; } }池化的好处是复用已有连接而不是每个请求都重新建立连接Min / Max 按实际并发量调超时时间可以配合DBCommandTimeout一并设置。多环境配置分开维护在 appsettings.json 旁边建 appsettings.Production.json 覆盖生产参数启动时指定环境变量export ASPNETCORE_ENVIRONMENTProduction # Linux / macOS set ASPNETCORE_ENVIRONMENTProduction # Windows框架会按环境自动加载对应配置切环境不用改主文件也能避免生产和开发指向同一个库。 一张表看懂环境选型使用场景推荐组合典型瓶颈升级触发条件本地开发调试.NET Core 3.1 SDK 本地数据库 Memory 缓存首次 NuGet 还原慢需要更新框架版本切 Net6 / Net7 分支小团队内网SQL Server 或 MySQL 单机 Memory 缓存单机资源上限并发登录超过 50页面明显变慢生产上线MySQL Redis Nginx 反向代理大表查询慢、日志膨胀QPS 上升或需要多实例部署踩坑复盘与社区求助别把默认连接串当生产配置仓库里的 sa 密码和本机地址只是示例部署前确认改过。在跑初始化脚本之前先备份脚本先删表再建表对着已有数据的库直接执行数据就没了。别把端口被占用当项目问题先用 netstat 查清 5000 / 5001 被哪个进程占着再决定改端口还是释放端口。在社区提问之前先收集证据附上dotnet --list-sdks输出、appsettings.json 的 SystemConfig 段和完整报错大多数起不来的问题看到这三样就能回答。按上面的路径走仍卡住的话到项目仓库提一个可复现的 Issue或到官方文档站、社区交流群提问信息越全响应越快。下一步建议在仓库根目录执行一次dotnet restore成功后启动 YiSha.Admin.Web——登录页能显示出来环境就通了大半。【免费下载链接】YiShaAdmin基于 .NET Core MVC 的权限管理系统代码易读易懂、界面简洁美观项目地址: https://gitcode.com/GitHub_Trending/yi/YiShaAdmin创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考