简介这份C# MES系统源码面向希望理解制造执行系统架构与实现方式的中级.NET开发者围绕生产订单、工序、设备状态、实时数据采集与报表展示等场景提供一套结构完整的示例工程。压缩包共95个文件约1.81MB以54个cs源码文件为核心辅以24个resx界面资源、5个dll依赖库、3个sql建表与查询脚本以及sln解决方案、csproj项目文件和说明文档覆盖基础资料、基础模块、数据报表、数据采集等目录。已有3221人学习下载。读者可从中梳理三层架构分层、实体类与数据访问、串口/网络通信采集、工作流与权限控制等实现思路并借助SQL脚本快速还原数据库结构适合做课程设计、二次开发前的结构参考或MES入门研读。1. 从一张手写派工单说起C# MES 源码接住的是车间里最脏的那段流程车间里最常见的画面是计划员在 Excel 里排产班组长拿打印单派工操作工干完活回办公室补录等数据汇总上来已经过去一天。这套 C# MES 源码要接的就是这段最脏的流程——工单下发、扫码过站、报工采集、看板展示一条链路走完数据秒级落库。它基于 ASP.NET Core 分层架构后端 Web API、车间看板、工位端 WinForms 三端共存业务表结构完整既能当二次开发的底子也能给中小车间撑起第一版数字化。下面按「能干什么、怎么分层、怎么跑、怎么改」的顺序拆开讲。2. 技术栈与工程结构从 .sln 到七个 csproj 的分层逻辑2.1 选型ASP.NET Core EF Core SQL Server 这套组合在车间里为什么够用工厂现场的 IT 环境有个共同点服务器是 Windows Server客户端是装了七八年的工控机网络是有线局域网运维往往就一个人。这套源码的选型基本是照着这个约束倒推出来的而不是追新。后端用 ASP.NET Core Web API 宿主一个进程同时挂控制器和 SignalR Hub部署时复制目录、注册个服务就能跑数据访问用 EF Core迁移脚本自带版本管理现场升级不用手工比对表结构数据库默认 SQL ServerProvider 在MesDbContext里是可替换的换成 MySQL 只需要改一行UseSqlServer。看板没走前后端分离用的是 Blazor Server。理由很实际车间看板的需求是「大字、实时、别崩」不需要复杂交互Blazor 把渲染放在服务端工控机上有个浏览器就能看改个字段重新编译 dll 即可省掉一整套 npm 构建链。工位端坚持用 WinForms因为扫码枪、电子秤、打印机这些外设的驱动大多是 Windows 原生库WPF 也能做但 WinForms 上手成本更低老师傅的机器上跑得更稳。设备采集这块源码里封装了 Opc.Ua.Client 和 NModbus 两套客户端前者对接支持 OPC UA 的 PLC 和新一点的采集网关后者对接还在跑 Modbus TCP 的老设备。后台采集任务挂在BackgroundService上跟 Web 宿主同进程不额外引入 Windows 服务少一个部署环节就少一类故障。日志用 Serilog 写文件并按天滚动现场出问题第一件事就是让运维把logs目录打包发过来。至于为什么不做微服务一个车间一天的报工记录也就几万条量级单库单实例绰绰有余拆成服务只会让现场多出几个要监控的端口。分层单体在这个场景下不是妥协是正确解。2.2 目录结构六个业务项目各自的职责边界拿到源码先看解决方案的目录基本能判断这套东西能不能改。下面是主干结构src下六个项目加一个测试工程依赖方向是单向的不允许反向引用。Mes.sln ├── src/ │ ├── Mes.Domain/ 实体、枚举、领域常量零第三方依赖 │ ├── Mes.Infrastructure/ DbContext、仓储实现、OPC/Modbus 客户端、种子数据 │ ├── Mes.Application/ 业务服务、DTO、过站规则引擎、状态机 │ ├── Mes.Api/ Web API 宿主、控制器、SignalR Hub、后台采集服务 │ ├── Mes.Web/ Blazor Server 车间看板 │ └── Mes.Station/ WinForms 工位端 └── tests/ └── Mes.Tests/ xUnit 单元测试主要覆盖状态机和规则引擎Mes.Domain里放的是纯 POCO没有任何[Key]、[Required]之类的框架特性映射全部写在Mes.Infrastructure的 Fluent API 里。好处是领域层可以被单元测试直接 new 出来也不用为了换个 ORM 去改实体。Mes.Application是唯一放业务逻辑的地方控制器里只做参数校验和结果包装超过十行的逻辑一律下沉到服务层。Mes.Api和Mes.Web都引用Mes.Application但两者之间不互相引用。看板要的数据通过IWorkOrderQueryService拿走的是同一个服务层不会出现「看板统计口径和接口对不上」这种经典问题。Mes.Station稍微特殊它不直接引用 Application而是通过 HTTP 调 API这样工位端的升级和后端解耦现场可以只换 dll 不重装客户端。提示如果打算把工位端改成浏览器方案Mes.Station可以整个去掉把扫码逻辑搬到Mes.Web的一个 Razor 页面里服务层一行不用动。2.3 启动与配置Program.cs里真正需要动的地方入口文件不长但每一行都对应一个现场的坑。下面这段是精简后的Mes.Api/Program.cs保留了需要关注的部分。var builder WebApplication.CreateBuilder(args); // 日志控制台 按天滚动的文件现场排障主要靠后者 builder.Host.UseSerilog((ctx, cfg) cfg .ReadFrom.Configuration(ctx.Configuration) .WriteTo.Console() .WriteTo.File(logs/mes-.log, rollingInterval: RollingInterval.Day)); // 数据库开启重试车间网络抖动时不至于整个请求失败 builder.Services.AddDbContextMesDbContext(opt opt.UseSqlServer( builder.Configuration.GetConnectionString(Mes), sql sql.EnableRetryOnFailure(3, TimeSpan.FromSeconds(5), null))); // 业务服务与规则引擎 builder.Services.AddScopedIWorkOrderService, WorkOrderService(); builder.Services.AddScopedIStationCheckService, StationCheckService(); builder.Services.AddSingletonIProcessRuleEngine, ProcessRuleEngine(); // 设备采集常驻后台任务 builder.Services.AddHostedServiceEquipmentCollectHostedService(); builder.Services.AddSignalR(); builder.Services.AddControllers(); var app builder.Build(); app.MapControllers(); app.MapHubAndonHub(/hubs/andon); // 看板与 Andon 灯共用的推送通道 app.Run();EnableRetryOnFailure这三个参数分别是重试次数、最大退避间隔和可重试的错误号列表留空表示用默认集合。车间里交换机重启、网线被叉车压断都遇到过这个配置能把偶发的连接中断挡掉大半。IProcessRuleEngine注册成单例是因为它内部缓存了规则表改规则时会通过IMemoryCache的 key 主动失效不需要重启。配置文件里真正要改的只有几项其余保持默认即可。{ ConnectionStrings: { Mes: Server.;DatabaseMesDb;Trusted_ConnectionTrue;TrustServerCertificateTrue }, Mes: { SiteCode: SITE01, DisplayTimeZone: Asia/Shanghai, ScanDebounceMs: 300, OfflineBufferSize: 5000 }, Opc: { Endpoint: opc.tcp://127.0.0.1:4840, PollIntervalMs: 1000, ReconnectBackoffMs: 5000 } }SiteCode会写进每条报工记录多厂区部署时靠它区分数据来源ScanDebounceMs是前端防重复提交的窗口后面避坑章节还会提到它DisplayTimeZone只影响展示库里统一存带偏移的时间。Opc节点在不需要采集设备的生产线上可以整段删掉宿主服务会自己跳过。3. 数据模型与核心链路工单、过站、报工三张表怎么串起来3.1 四张主表与字段取舍MES 的表能铺到几十张但真正决定系统能不能转起来的是四张工单、过站记录、SN 追溯、物料库存。源码里这四张表的字段都很克制没有一上来就堆自定义扩展字段。表名关键字段说明WorkOrderOrderNo、ProductCode、PlanQty、FinishedQty、Status、RowVersion工单主表OrderNo建唯一索引RowVersion做并发令牌OperationRecordWorkOrderId、OperationCode、Sn、OkQty、NgQty、StationCode、ReportedAt报工与过站记录合一一条记录代表一次过站动作SnTraceSn、ProductCode、CurrentOperation、Status单件产品的当前工序快照避免每次追溯都去扫全表MaterialStockMaterialCode、LocationCode、Qty、RowVersion线边库存扣料走乐观锁OperationRecord把「过站」和「报工」合成一张表是因为车间里这两个动作本来就是同一个物理操作——操作工扫一下 SN系统既记录了这件的过站也累加了工单的完工数。分成两张表反而会出现「过站了但没报工」的对账麻烦。SnTrace是一张冗余表作用是让追溯查询从「扫全表找这个 SN 的所有记录」变成「查一行拿当前状态」代价是每次过站要同步更新一次用事务包住就行。注意FinishedQty是累加字段不要拿它去做SUM(OperationRecord.OkQty)的实时计算看板上万行数据时性能差一个数量级。3.2 实体映射唯一索引和并发令牌写在 Fluent API 里实体类本身保持干净映射集中在一个OnModelCreating里方便一次性看全所有约束。public class WorkOrder { public long Id { get; set; } public string OrderNo { get; set; } default!; // 业务唯一键对外暴露用这个 public string ProductCode { get; set; } default!; public int PlanQty { get; set; } public int FinishedQty { get; set; } public WorkOrderStatus Status { get; set; } public DateTimeOffset CreatedAt { get; set; } // 带偏移跨时区不出错 public byte[] RowVersion { get; set; } default!; // 并发令牌 } public class MesDbContext : DbContext { public DbSetWorkOrder WorkOrders SetWorkOrder(); public DbSetOperationRecord OperationRecords SetOperationRecord(); protected override void OnModelCreating(ModelBuilder mb) { mb.EntityWorkOrder(e { e.ToTable(WorkOrder); e.HasIndex(x x.OrderNo).IsUnique(); // 工单号不允许重复 e.Property(x x.OrderNo).HasMaxLength(32).IsRequired(); e.Property(x x.RowVersion).IsRowVersion(); // 映射到 SQL Server 的 rowversion e.Property(x x.Status).HasConversionint(); // 枚举存 int方便 SQL 里直接看 }); mb.EntityOperationRecord(e { // 幂等的最后一道防线同一工单 工序 SN 只能有一条 e.HasIndex(x new { x.WorkOrderId, x.OperationCode, x.Sn }).IsUnique(); e.HasIndex(x new { x.StationCode, x.ReportedAt }); // 工位端补传时按时间捞 e.Property(x x.Sn).HasMaxLength(64).IsRequired(); }); } }IsRowVersion()在 SQL Server 上会生成rowversion类型EF Core 在SaveChanges时自动把原值放进WHERE条件更新影响行数为 0 就抛DbUpdateConcurrencyException。这套机制不需要业务代码写任何版本号比较比手写UPDATE ... WHERE Version v省心。那个三列组合唯一索引是整个系统防重复报工的根本。应用层的AnyAsync判断只是提前返回友好提示真正兜底的是索引——并发下两个请求同时通过检查的情况一定存在这时候数据库会拒绝第二条插入捕获DbUpdateException转成「重复报工」返回即可。3.3 工单状态机把 if-else 收进一张迁移表工单状态如果用if (status Created || status Released)这种写法散在各个方法里改一条规则要全项目搜。源码里的做法是把合法迁移写成字典任何状态变更都必须过CanTransit。public enum WorkOrderStatus { Created 0, // 已创建还没下发 Released 10, // 已下发到车间 InProduction 20, // 生产中 Paused 30, // 暂停 Closed 90, // 正常关闭 Cancelled 99 // 作废 } public static class WorkOrderStateMachine { private static readonly DictionaryWorkOrderStatus, WorkOrderStatus[] Allowed new() { [WorkOrderStatus.Created] new[] { WorkOrderStatus.Released, WorkOrderStatus.Cancelled }, [WorkOrderStatus.Released] new[] { WorkOrderStatus.InProduction, WorkOrderStatus.Cancelled }, [WorkOrderStatus.InProduction] new[] { WorkOrderStatus.Paused, WorkOrderStatus.Closed }, [WorkOrderStatus.Paused] new[] { WorkOrderStatus.InProduction, WorkOrderStatus.Cancelled } }; public static bool CanTransit(WorkOrderStatus from, WorkOrderStatus to) Allowed.TryGetValue(from, out var next) next.Contains(to); public static void EnsureCanTransit(WorkOrderStatus from, WorkOrderStatus to) { if (!CanTransit(from, to)) throw new BizException($工单状态不允许从 {from} 变更为 {to}); } }字典里没有Closed和Cancelled这两个 key意味着终态不可逆想返工只能新建一张工单。这条规则在现场引起过争议但坚持下来是对的——允许回退的工单状态最后一定会有对不上账的记录。BizException是自定义的业务异常API 层有个中间件专门捕获它转成 400 加业务错误码不会吐 500 堆栈给操作工看。3.4 报工接口幂等、事务、并发三件事一起处理报工是整个系统调用最频繁的接口工位端每扫一件就调一次。这段代码值得逐行看。[HttpPost(report)] public async TaskActionResultApiResult ReportAsync([FromBody] ReportRequest req) { // 1) 前置幂等检查命中直接返回成功工位端不会弹红色提示 var duplicated await _db.OperationRecords.AnyAsync(x x.WorkOrderId req.WorkOrderId x.OperationCode req.OperationCode x.Sn req.Sn); if (duplicated) return Ok(ApiResult.Ok(重复报工已忽略)); await using var tx await _db.Database.BeginTransactionAsync(); // 2) 拿工单并校验状态不在生产中一律拒绝 var order await _db.WorkOrders.FirstOrDefaultAsync(x x.Id req.WorkOrderId) ?? return NotFound(ApiResult.Fail(工单不存在)); if (order.Status ! WorkOrderStatus.InProduction) return BadRequest(ApiResult.Fail($工单当前状态为 {order.Status}不能报工)); // 3) 写记录 累加完工数同一事务内完成 _db.OperationRecords.Add(new OperationRecord { WorkOrderId order.Id, OperationCode req.OperationCode, Sn req.Sn, OkQty req.OkQty, NgQty req.NgQty, StationCode req.StationCode, ReportedAt DateTimeOffset.Now, Result req.NgQty 0 ? RecordResult.Ng : RecordResult.Ok }); order.FinishedQty req.OkQty; try { await _db.SaveChangesAsync(); // RowVersion 不匹配会在这里抛并发异常 await tx.CommitAsync(); } catch (DbUpdateConcurrencyException) { await tx.RollbackAsync(); return Conflict(ApiResult.Fail(工单已被其他工位更新请重新扫码)); } catch (DbUpdateException) // 组合唯一索引冲突并发下的兜底 { await tx.RollbackAsync(); return Ok(ApiResult.Ok(重复报工已忽略)); } // 4) 推送看板失败不影响主流程 await _hub.Clients.All.SendAsync(orderChanged, order.Id, order.FinishedQty); return Ok(ApiResult.Ok()); }请求体ReportRequest只有六个字段WorkOrderId、OperationCode、Sn、OkQty、NgQty、StationCode。不带时间戳是因为时间以服务端为准工位端的钟不可信——现场工控机的时间偏差一两个小时是常事如果让客户端传时间报表按小时统计会直接乱掉。DbUpdateConcurrencyException和DbUpdateException要分开 catch。前者是工单被别的工位抢先更新比如两个工位同时报同一张单应该让操作工重扫后者大概率是唯一索引冲突本质是重复报工返回成功反而更符合现场预期因为那件产品确实已经报过了。3.5 过站校验用规则表代替硬编码的工序判断过站校验要回答的问题是「这个 SN 现在能不能过这道工序」。硬编码的写法是在每个工位写一段if产品一多就失控。源码里把规则抽成表一条规则描述一个产品在某道工序的前置条件。public class StationRule { public long Id { get; set; } public string ProductCode { get; set; } default!; // 支持 * 通配 public string OperationCode { get; set; } default!; public string PrevOperationCode { get; set; } default!; // 必须已完成的工序 public bool RequireMaterialScan { get; set; } // 是否强制扫料 public int MaxNgRateBp { get; set; } // 不良率上限万分比 public bool Enabled { get; set; } }校验服务的核心逻辑是先取规则、再逐条判定没有匹配到规则时默认放行。public async TaskCheckResult CheckAsync(CheckRequest req, CancellationToken ct) { // 精确匹配优先于通配避免通用规则盖住产品专属规则 var rule await _db.StationRules .Where(r r.Enabled (r.ProductCode req.ProductCode || r.ProductCode *) r.OperationCode req.OperationCode) .OrderByDescending(r r.ProductCode ! *) .FirstOrDefaultAsync(ct); // 没配规则就放行宁可少拦也不要卡住产线 if (rule is null) return CheckResult.Pass(); var prevDone await _db.OperationRecords.AnyAsync(x x.Sn req.Sn x.OperationCode rule.PrevOperationCode x.Result RecordResult.Ok, ct); if (!prevDone) return CheckResult.Block($SN {req.Sn} 未完成前道工序 {rule.PrevOperationCode}); return CheckResult.Pass(); }「没配规则默认放行」这个设计在现场救过场。有次新产品试产工艺还没来得及维护规则如果默认拦截整条线直接停摆放行最多是漏检事后能靠追溯补。当然这个策略要在上线前和品质部门对齐不是所有厂都能接受。MaxNgRateBp用的是万分比而不是百分比因为double存 0.01% 这种值会有精度问题存整数 1 表示万分之一比较和统计都不会出错。这条经验来自于之前一个项目里不良率怎么算都对不上的血泪史。4. 部署与跑通本地起服务、连库、联调工位端4.1 数据库迁移与种子数据第一次跑起来最省事的路径是本地装一个 SQL Server Express然后用 EF Core 迁移建库。先确认dotnet-ef工具装了版本要和项目的 EF Core 包对齐。# 安装或更新迁移工具版本号跟 csproj 里的 EF Core 保持一致 dotnet tool install --global dotnet-ef --version 8.* # 还原依赖 dotnet restore Mes.sln # 生成初始迁移注意 startup-project 要指到 Api否则拿不到连接串 dotnet ef migrations add Init \ --project src/Mes.Infrastructure \ --startup-project src/Mes.Api # 应用到数据库 dotnet ef database update \ --project src/Mes.Infrastructure \ --startup-project src/Mes.Api--project和--startup-project这两个参数必须分开指。迁移文件生成在 Infrastructure 项目里但连接串和DbContext的注册在 Api 项目里只指一个会报「找不到设计时 DbContext」。这个问题在初次接触分层项目的人身上几乎必踩。种子数据写得比较简单只在表为空时插一张工单和两条规则方便打开看板就能看到东西。public static async Task SeedAsync(MesDbContext db) { if (await db.WorkOrders.AnyAsync()) return; // 已有数据不重复插 db.WorkOrders.Add(new WorkOrder { OrderNo WO-20240501-001, ProductCode P-1001, PlanQty 500, Status WorkOrderStatus.InProduction, CreatedAt DateTimeOffset.Now }); db.StationRules.AddRange( new StationRule { ProductCode P-1001, OperationCode OP20, PrevOperationCode OP10, Enabled true }, new StationRule { ProductCode *, OperationCode OP10, PrevOperationCode OP00, Enabled true }); await db.SaveChangesAsync(); }4.2 后端与看板启动数据库就绪后两个进程分别起来。API 默认监听 5080看板用 5081端口写在各自的launchSettings.json里。# 终端一启动 Web API看日志里有没有迁移和种子数据成功的提示 dotnet run --project src/Mes.Api --urls http://0.0.0.0:5080 # 终端二启动 Blazor 看板 dotnet run --project src/Mes.Web --urls http://0.0.0.0:5081用0.0.0.0而不是localhost是为了让车间局域网里的工位机能直接访问。如果只在开发机上跑改回localhost更安全。起来之后先拿 curl 验一下报工接口比在工位端上盲试快得多。curl -X POST http://localhost:5080/api/workorder/report \ -H Content-Type: application/json \ -d {workOrderId:1,operationCode:OP20,sn:SN0001,okQty:1,ngQty:0,stationCode:ST-01}第一次返回{code:0,message:ok}再发一次同样的请求会返回「重复报工已忽略」——这说明幂等生效了组合唯一索引和前置检查都在工作。如果第二次返回的是 500说明前置检查那段逻辑被跳过了去查一下OperationRecords的索引有没有真的建出来。4.3 工位端联调扫码枪输入与离线缓存工位端的连接配置在App.config里改完不用重新编译现场运维自己就能改。!-- Mes.Station/App.config -- appSettings add keyApiBaseUrl valuehttp://192.168.1.10:5080 / add keyStationCode valueST-01 / add keyOperationCode valueOP20 / add keyScanEndChar value13 / !-- 扫码枪以回车结尾13 是 CR -- add keyRequestTimeoutMs value3000 / /appSettings扫码枪在系统里表现为一个键盘字符一个个进来最后补一个回车。所以接收逻辑不能直接绑TextBox.TextChanged那样每输入一个字符就触发一次一个 20 位的 SN 会发 20 个请求。源码里的做法是攒够一个完整的扫描周期再提交。private readonly StringBuilder _buffer new(); private DateTime _lastKeyAt DateTime.MinValue; private void OnKeyPress(object sender, KeyPressEventArgs e) { // 两次按键间隔过长认为上一次是误触清空重来 if ((DateTime.Now - _lastKeyAt).TotalMilliseconds 120) _buffer.Clear(); _lastKeyAt DateTime.Now; if (e.KeyChar (char)13) // 回车 一次扫描结束 { var sn _buffer.ToString().Trim(); _buffer.Clear(); if (sn.Length 0) _ SubmitAsync(sn); e.Handled true; // 吃掉回车防止触发默认按钮 return; } _buffer.Append(e.KeyChar); }120 毫秒这个阈值是根据扫码枪的字符间隔定的一般扫码枪连续输出时字符间隔在 10 到 30 毫秒人手敲键盘最快也要 100 毫秒以上。设得太小会把一次扫描拆成两次设得太大又会把两次快速扫描粘在一起。网络不通时的兜底是落盘重传文件按行存 JSON恢复后按顺序补。public class OfflineQueue { private readonly string _file Path.Combine( AppDomain.CurrentDomain.BaseDirectory, pending.jsonl); // 请求失败先落盘避免现场因为网络问题停线 public void Enqueue(ReportRequest req) File.AppendAllText(_file, JsonSerializer.Serialize(req) Environment.NewLine); public IEnumerableReportRequest Drain() { if (!File.Exists(_file)) yield break; foreach (var line in File.ReadAllLines(_file)) if (!string.IsNullOrWhiteSpace(line)) yield return JsonSerializer.DeserializeReportRequest(line)!; File.Delete(_file); } }补传的时机放在工位端每次成功提交之后顺手跑一遍不做定时器。这样网络恢复后第一批数据马上就能上去不用等下一个轮询周期。补传失败时不要删文件否则数据就真丢了。5. 避坑与排查上线前必须压一遍的 5 个坑5.1 五个高频故障的现象、成因与处置第一坑报工数量翻倍。现象是工单完工数比实际产量多出百分之几而且集中在网络慢的工位。原因多半是客户端超时重试第一次请求其实已经到了服务端并写库成功只是响应在路上丢了工位端认为失败又发了一次。解决分两层应用层的前置检查只能挡住串行重复真正管用的是WorkOrderId OperationCode Sn的组合唯一索引以及客户端RequestTimeoutMs不要设得太短——3 秒对局域网内的插入操作已经足够。第二坑看板越用越卡重启就好。现象是早上刚上班时看板刷新很快到下午要三四秒才响应一次。原因通常是 EF Core 的查询跟踪没关加上循环里逐条查明细造成的 N1DbContext又因为被注册成 Scoped 而保持着大量实体引用。解决是所有只读查询加AsNoTracking()列表页用Select投影到 DTO 而不是返回实体看板接口单独走一套IDbContextFactory创建的短生命周期上下文。第三坑设备采集整点丢一段数据。现象是每小时的第 59 分钟到下一个整点之间的采集值是空的其余时间正常。原因是 OPC UA 的会话有默认超时长时间空闲后服务端会主动断开而采集任务里只写了try没写重连异常被最外层吞掉了任务继续跑但会话已经废了。解决是把采集循环包在while里捕获ServiceResultException后按ReconnectBackoffMs做指数退避重连同时加一条心跳写入连续三次失败就记 Error 日志并推送告警。第四坑报表时间对不上。现象是夜班 23 点到次日 1 点的产量在报表里被算到了前一天跨月的时候还会出现整月的数字偏差。原因是数据库里混用了GETDATE()的服务器本地时间和代码里DateTime.Now的客户端时间两边时区或者夏令时策略不一致。解决是全部换成DateTimeOffset写入时统一取服务端时间展示时再按DisplayTimeZone转换SQL 里禁止出现GETDATE()需要默认值时用SYSDATETIMEOFFSET()。第五坑并发扣料超卖。现象是线边库存偶尔变成负数触发时机集中在换班前后多个工位同时开工。原因是「查库存 - 判断够不够 - 扣减」这三步没有原子性两个请求都读到 10都判断够都扣 6最后变成 -2。解决是给MaterialStock加RowVersion并发令牌捕获DbUpdateConcurrencyException后重试一次如果业务上允许直接用一条UPDATE MaterialStock SET Qty Qty - n WHERE Qty n更干脆影响行数为 0 就是库存不足。5.2 出问题先看哪三处日志、执行计划、现场时序现场报障时最忌讳的是凭感觉改代码。我的习惯是先按固定顺序看三样东西八成的问题能在这三步内定位。第一处是 Serilog 的日志文件。每个请求进来会打一条包含OrderNo和Sn的 Info 日志异常会带完整堆栈。查「某件产品为什么没报上」时直接 grep 那个 SN能看到它经过了哪几个接口、在哪一步返回了什么。第二处是慢查询。把看板接口的 SQL 从日志里捞出来丢进 SQL Server Management Studio 看实际执行计划重点看有没有Table Scan和「估计行数与实际行数差异巨大」。后者通常意味着统计信息过期UPDATE STATISTICS一下就能好不用改代码。第三处是现场时序。工位端的操作日志、API 的接收日志、数据库的写入时间这三个时间点排在一起看就能判断是网络延迟、客户端重试还是服务端处理慢。曾经有个「扫码没反应」的问题最后发现是工位机的系统时间比服务器快了 40 分钟日志时间一对就露馅了。注意上线前把日志级别设成 Information不要图省事用 Debug。Debug 在高频报工场景下一天能写出几个 G磁盘满了整个服务会挂。6. 二次开发三个最常见的改造点和一套验证方法拿到这套源码的人改造需求基本集中在三件事上加新工序、对接上游系统、改看板样式。这三件事的落点完全不同找错文件会浪费很多时间。改造需求主要落点需要注意新增一道工序StationRule表加一行 工位端App.config改OperationCode不需要改代码但要确认前道工序的OperationCode拼写一致对接 ERP 拉工单新建ErpSyncHostedService实现IWorkOrderService.ImportAsync外部单号要做映射不能直接当OrderNo用看板加图表Mes.Web下新建组件数据走IWorkOrderQueryService查询必须AsNoTracking别直接注入MesDbContext换数据库Program.cs里换 Provider重做迁移rowversion在 MySQL 里要换IsRowVersion的等价写法加新的过站规则类型StationRule加字段 CheckAsync加分支新字段要给默认值历史数据不能因为空值被拦加规则这件事值得单独说因为它是最不需要写代码的扩展点。比如某个产品要求过站前必须扫物料条码只要在StationRule上已经有RequireMaterialScan字段插一条记录就完事。如果字段不存在加了字段之后要记得给历史数据补默认值ALTER TABLE加非空列时给DEFAULT 0否则迁移会失败。// 给已有规则表加一条「OP30 必须扫料」的规则不需要改任何 C# 代码 db.StationRules.Add(new StationRule { ProductCode P-1001, OperationCode OP30, PrevOperationCode OP20, RequireMaterialScan true, // 新开的开关 MaxNgRateBp 500, // 不良率超过 5% 就拦 Enabled true }); await db.SaveChangesAsync();改完之后怎么验证我的做法是先跑单元测试确认状态机和规则引擎没被破坏再用 curl 打三个用例正常过站、跳过前道工序、重复报工。这三个用例覆盖了大部分回归场景五分钟能跑完。别指望在工位端上手点手点的路径永远覆盖不全。有个教训印象很深早期改规则引擎时为了图快直接在CheckAsync里加了一段if (req.ProductCode P-1001)的特判当时验证通过了三个月后这个产品停产那段特判没人记得删新产品的编码规则一变直接被这段历史代码拦在线上。从那以后我每次往业务服务里加特判之前都会先问一句「这个条件能不能塞进规则表」能塞就绝不写进代码。配置化的东西改错了能回滚代码里的硬编码只能靠人记。希望帮到你。本文还有配套的精品资源点击获取
企业数字化 ERP 产品动态
相关推荐
微信小程序招聘系统SSM后端与Spring Boot迁移实践 简介:面向高校学生、Java全栈学习者与课程设计开发者的一套微信小程序求职招聘系统源码,围绕校园兼职场景串联求职者、商家与管理员三类角色:小程序端完成微信授权登录、姓名性别院系班级等个人资料完善、兼职分类筛选、联系商户、预约面试及… · 2026/11/19 17:59:40
DP83867千兆PHY驱动移植与RGMII时序调试 简介:围绕 dp83867 以太网控制器芯片的开发资料,面向嵌入式驱动工程师、物联网设备开发者及需要熟悉 TI 以太网 PHY 配置的技术人员,帮助打通从芯片手册查阅到 C 语言驱动实现的链路。压缩包共 2 个文件,包含 1 份 PDF 技术手册和… · 2026/11/5 23:25:27
HTML表格源码实战:边框合并、列宽控制与粘性表头调优 简介:面向 HTML 初学者与网页制作入门者的表格练习源码包,围绕表单与表格的搭建展开,适合课堂作业、自学练手与教学演示等场景,帮助读者理解表格结构、行列组织及基础样式呈现方式。压缩包共 5 个文件,约 30KB… · 2026/11/20 18:45:23
户县草堂电工证保姆级教程:实操考试心里没底怕挂科?这份攻略帮你稳过 户县草堂电工证保姆级教程:实操考试心里没底怕挂科?这份攻略帮你稳过 实操考试心里没底怕挂科?你不是一个人。尤其是像户县草堂电工证这种含金量高、实操要求严的特种作业证,很多学员担心自己动手操作不熟练、现场突发状况应对不了,最后直接凉在考试现场… · 2026/11/21 0:25:37
通化低压电工证年审怎么搞?怕考不过白交培训费的看过来 通化低压电工证年审怎么搞?怕考不过白交培训费的看过来 你是不是正准备报名通化低压电工证年审,却担心白交钱?别急,我来帮你梳理清楚,搞懂通化低压电工证年审到底怎么操作,还能让你知道这证是不是 全国通用 ,值不值得花这笔钱。 先说重点:… · 2026/11/21 0:25:37
棉湖电工证考试流程千万别踩坑,怕考不过白交培训费 棉湖电工证考试流程千万别踩坑,怕考不过白交培训费 怕考不过白交培训费?你不是一个人。我见过太多学员因为没搞清楚棉湖电工证考试流程,结果要么报名资料不齐被退,要么考试没通过,培训费打了水漂。 千万别踩坑… · 2026/11/21 0:25:37
通化低压电工证年审怎么办理?全国通用证书怎么考不挂科 通化低压电工证年审怎么办理?全国通用证书怎么考不挂科 实操考试心里没底怕挂科,特别是像你这样在南阳从事房建工程的电工,低压电工证年审不仅关系到你能不能继续干活,也直接影响你的职业发展。全国通用的证书一旦过期,不仅影响项目进度,还可能面临被停… · 2026/11/21 0:25:37
铜川市电工证考试实操怕挂科?考前押题帮你稳过 铜川市电工证考试实操怕挂科?考前押题帮你稳过 你是不是也像我一样,考前一想到实操考试,心里就发慌?手忙脚乱、操作失误,一个不小心就挂科,那滋味真的不好受。尤其是铜川市电工证考试,实操部分占了很大比重,很多人就栽在这块儿。不过别担心,… · 2026/11/21 0:25:37
长春初级电工证怎么考?通过率揭秘全在这里 长春初级电工证怎么考?通过率揭秘全在这里 之前考的证在外省能不能转过来?这几乎是每个想从事电工工作的人都会问的问题。特别是那些在外地打拼多年、手里握着一张“外地电工证”的人,到了长春想继续干这一行,第一反应就是“我的证能用吗?”。今天我们就… · 2026/11/20 16:18:19
国内电工证报考条件与考试时间 低压电工证怎么考?学历不高也能报名,官方报名入口全在这 你是不是经常听说“电工证是入行门槛”,但又担心自己学历不够、经验不足,根本报不了名?别急,今天就带你从零了解【国内电工证】的报考流程、考试内容,还有怎么在 官方报名入口… · 2026/11/20 18:25:07
电工作业时如何断电?电子证书到底能不能全国通用? 电工作业时如何断电?电子证书到底能不能全国通用? 实操考试心里没底怕挂科,特别是电工作业时如何断电这一操作,不仅关系到你能不能拿到证书,更关系到以后能不能顺利上岗。很多人觉得这不过就是“断个电”,但其实这里面的门道可不少,稍有不慎就可能出错… · 2026/11/20 17:56:32
电工证征求意见2026河南最新政策怎么应对?学历不高也能考! 电工证征求意见2026河南最新政策怎么应对?学历不高也能考! 你是不是也担心自己学历不高, 怕报不上名 ?尤其是像焦作水利工程这样的从业者,常年在一线作业,但证书却成了晋升、转岗、接项目的关键门槛。 2026河南最新政策… · 2026/11/21 0:00:17
电工证征求意见怎么填?含金量高不高?济源电工朋友看过来 电工证征求意见怎么填?含金量高不高?济源电工朋友看过来 不知道去哪报名怕被中介坑,电工证征求意见填错了不仅白费钱,还可能影响后续考试和工作。最近很多济源的电工朋友都在问: 电工证征求意见怎么填… · 2026/11/21 0:00:17
房建企业特种工考前押题怎么找?别让培训费打了水漂 房建企业特种工考前押题怎么找?别让培训费打了水漂 怕考不过白交培训费?房建企业特种工考试难度高、题型多,很多人报名后才发现没有合适的复习资料,最终考试落榜,白白浪费了时间和金钱。别担心,掌握【考前押题】的技巧,能让你事半功倍,顺利通过考试。… · 2026/11/21 0:00:17
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:25:45
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:25:54
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:26:03