当前正式版 · 2026年9月3日发布

DBErp 3.0.4版本说明、安装与升级文档

面向新用户和已安装用户，集中提供本次更新内容、下载安装路径、服务器环境要求与升级注意事项。

新用户下载安装查看升级方式

新用户

下载 Web 安装包，按照安装流程完成部署。

已安装 3.x

优先通过后台“系统更新中心”分步在线升级。

无法在线更新

完整备份后，按照离线升级教程操作。

功能更新

DBErp 3.0.4 更新说明

2026年9月3日

这次更新补齐销售毛利与库存成本能力，完善本地部署授权和系统邮件，并修正往来结算、退货账款与库存异常相关问题。

新增

销售毛利：按已出库口径计算收入、销售成本与毛利，查询中心与统计分析可展示相关指标。
库存移动平均成本：入库可记录单位成本，库存余额与流水支持成本数据；并提供历史成本回填命令。
系统邮件服务：后台可配置 SMTP，用于系统通知类邮件。
本地部署授权：支持激活与停用，证书采用公钥校验。

改进

主数据删除保护：产品、岗位、部门在存在业务引用时禁止删除，并给出明确提示。
库存异常：快照同步加锁，避免并发冲突；列表支持手动刷新。
查询与报表：单据查询仓库筛选、商品编码/名称搜索统一；产品排行搜索优化；报表支持聚合级别与排名维度。
导入导出：多规格产品表头匹配更准确；导出增加行数上限提示。
页面体验：统一页头操作分组；工作台间距与更新公告 widget 显示逻辑优化。

修正

采购/销售退货按关联订单处理应收应付；作废退货时刷新对应账款。
核销时锁定并校验收付款、应收应付单据，避免引用缺失导致异常。
结算调整在减少未核销余额时加强校验；独立销售退货的应收调整更准确。
单据行切换单位时按金额守恒转换单价。
无批次在库序列号时，库存异常不再误报。

已安装 3.x 用户请优先从后台升级。无法在线更新时，可下载 3.0.4 更新包，并严格按照离线升级教程操作。

查看 3.0.3 更新说明 · 2026年8月27日

支持对接 AI 助手与外部 AI 查询增加官方资讯，可在系统中查看官方消息系统更新增加预检、分步执行与恢复能力优化插件中心信息、权限设置与无权限提示

查看 3.0.1 更新说明 · 2026年8月10日

修复 open_basedir 环境下的 PHP 诊断异常修复 MariaDB 聚合别名排序问题完善出库数量字段和打印能力提升 PHP CLI 更新执行兼容性支持发票可见性控制审计日志支持中文动作关键词过滤新增 404 页面并完善英文语言包优化信用、询价与更新后清理体验

版本亮点

核心业务持续完善，成本与毛利更清楚

3.x 已覆盖完整进销存主流程；3.0.4 补充销售毛利、库存移动平均成本、系统邮件与本地部署授权。

业务流程更完整

采购、销售、出入库、退货、收付款和核销形成完整链路。

库存变化更清楚

支持多仓、批次、序列号、效期、调拨、盘点、库存流水与移动平均成本。

经营数据更直观

经营工作台、查询中心与统计分析可查看销售、库存及已出库口径的毛利指标。

权限和操作可追溯

模块授权、关键操作审计和数据导出权限帮助企业管好数据。

更新过程更稳定

提供更新前预检、分步执行与更清晰的异常处理提示。

官方能力按需扩展

站点注册后可使用授权、资讯、系统更新与官方插件中心；本地部署支持激活与停用。

官方插件不影响主程序核心使用

AI 助手、外部 AI 接入、轻量审批、发票辅助、条码标签、主数据导出和消息通知等能力可根据需要安装。插件授权与服务权益以系统提示、购买页面或合同为准。

新装与升级

根据当前状态选择正确路径

安装包用于新部署；已有生产系统应通过更新中心或官方离线教程升级。

新用户

首次安装

下载最新 Web 安装包，或使用 DBPanel（可选），按安装向导完成初始化。

下载 Web 安装包

已安装 3.x · 推荐

后台在线升级

查看升级指引

无法在线更新时

离线更新

下载 3.0.4 更新包，并严格按照官方离线手工升级教程操作。

先查看离线升级教程下载更新包

重要：不要把新安装包直接解压覆盖已有生产系统。3.x 以下版本请先联系官方确认升级方式。

安装要求

服务器环境与安装流程

部署前先确认运行环境、目录权限和 Web 服务配置，能够减少安装过程中反复排查。

基础环境

Web 安装包已包含运行依赖，普通用户无需执行 Composer；仅源码部署或开发调试时需要 Composer 2.x。

PHP 版本PHP 8.3 或更高版本

Web 服务Nginx 或 Apache

数据库MySQL 8.0+ 或 MariaDB 10.6+

网站运行目录必须指向项目的 public 目录

文件权限storage、bootstrap/cache 目录需要可写权限

HTTPS正式环境建议启用 HTTPS

PHP 扩展要求

服务器上建议优先确认

这些扩展与数据库、字符处理、压缩及核心业务关系密切。

bcmathctypecurlfileinfointlmbstringopensslpdopdo_mysqlzip

通常随 PHP 提供，仍建议核对

不同系统镜像或服务器面板的默认配置可能存在差异。

domfilterhashjsonlibxmlpcresessionsimplexmltokenizerxmlxmlreaderxmlwriter

Nginx 伪静态规则

以下仅为伪静态规则示例；完整站点仍需正确配置 PHP-FPM、网站运行目录和 HTTPS。

nginx 伪静态规则

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location ^~ /livewire {
    try_files $uri $uri/ /index.php?$query_string;
}

location ^~ /private-storage/ {
    try_files $uri /index.php?$query_string;
}

安装流程

下载安装包

新用户从官方下载中心获取 Web 安装包。

上传并解压

将安装包上传到服务器目标目录并解压。

设置运行目录

将网站运行目录设置为 public。

配置运行环境

选择 PHP 8.3+，创建并配置数据库。

设置目录权限

确保运行时目录具备正确的写入权限。

运行安装向导

访问站点并按照页面提示完成初始化。

遇到问题或有改进建议？

请通过官方反馈渠道提交环境信息、问题现象和复现步骤，方便技术人员定位。

提交反馈邮件支持

还没有安装 DBErp？

可以先进入演示站了解实际界面，再下载免费版部署。

进入在线演示