# mxpkj_base

**Repository Path**: mxp_server/mxpkj_base

## Basic Information

- **Project Name**: mxpkj_base
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-22
- **Last Updated**: 2025-12-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 码晓频科技核心业务系统

提供统一的业务功能和系统集成

## 项目结构

- module-auth: 认证模块
- module-common: 公共模块
- module-core: 核心业务模块
- module-file: 文件管理模块
- module-middleware: 中间件模块
- module-mq: 消息队列模块

## 启动项目

### 标准启动方式

```bash
# 启动核心业务模块
./gradlew :module-core:bootRun
```

### 无警告启动方式

为了解决Netty和其他库产生的警告，我们提供了一个专用的启动脚本：

```bash
# 启动核心业务模块（无警告）
./run-without-warnings.sh
```

该脚本添加了以下JVM参数来解决警告：

- `--enable-native-access=ALL-UNNAMED`: 解决Netty本地库访问警告
- `--add-opens=java.base/java.lang=ALL-UNNAMED`: 解决Java语言相关警告
- `--add-opens=java.base/java.util=ALL-UNNAMED`: 解决Java工具类相关警告
- `--add-opens=java.base/jdk.internal.misc=ALL-UNNAMED`: 解决内部工具类相关警告
- `--add-opens=java.base/sun.nio.ch=ALL-UNNAMED`: 解决NIO相关警告
- `--add-opens=java.base/sun.util.calendar=ALL-UNNAMED`: 解决日历相关警告

## 构建项目

```bash
# 构建整个项目
./gradlew build

# 构建并跳过测试
./gradlew build -x test
```

## 项目配置

项目使用Nacos作为配置中心，需要确保Nacos服务正常运行。

## 推荐插件

- `Alibaba Cloud Toolkit`
- `Apifox Helper`
- `Batch Scripts support`
- `CodeGlance Pro`
- `Developer Tools`
- `GitHub`
- `GitLab`
- `Gradle Dependencies Helper`
- `Grep Console`
- `HighlightBracketPair`
- `Json Parser And Code Generation`
- `Lombok`
- `Maven Helper`
- `MyBatis Log Free`
- `MyBatisCodeHelperPro`
- `Rainbow Brackets Lite`
- `SonarQube for IDE`
- `String Manipulation`
- `Trae AI`

## Gradle 常用命令指南

本文档列出了常用的 Gradle 命令，帮助您快速构建、清理、查看依赖树以及升级依赖。

### 1. 升级依赖

#### 检查依赖更新

使用 `gradle-versions-plugin` 插件检查依赖更新：

```bash
    ./gradlew dependencyUpdates --no-parallel
```

#### 升级 Gradle Wrapper

升级 Gradle Wrapper 到指定版本（例如 `9.2.1`）：

```bash
    ./gradlew wrapper --gradle-version=9.2.1
```

### 2. 构建项目

#### 构建项目

运行以下命令构建项目：

```bash
    ./gradlew build
```

#### 跳过测试构建

如果不想运行测试，可以添加 `-x test` 参数：

```bash
    ./gradlew build -x test
```

### 3. 清理项目

#### 清理构建输出

运行以下命令清理构建输出（删除 `build` 目录）：

```bash
    ./gradlew clean
```

#### 清理并重新构建

清理构建输出并重新构建项目：

```bash
    ./gradlew clean build
```

### 4. 查看依赖树

#### 查看项目依赖树

运行以下命令查看项目的依赖树：

```bash
    ./gradlew dependencies
```

#### 查看特定配置的依赖树

例如，查看 `runtimeClasspath` 的依赖树：

```bash
    ./gradlew dependencies --configuration runtimeClasspath
```

#### 过滤依赖树

使用 grep 过滤依赖树（例如，查找 `spring` 相关的依赖）：

```bash
    ./gradlew dependencies | grep -E "spring"
```

### 5. 运行测试

#### 运行所有测试

运行项目中的所有测试：

```bash
    ./gradlew test
```

#### 运行单个测试类

运行指定的测试类（例如 `MyTest`）：

```bash
    ./gradlew test --tests "com.example.MyTest"
```

#### 运行单个测试方法

运行指定的测试方法（例如 `MyTest.myMethod`）：

```bash
    ./gradlew test --tests "com.example.MyTest.myMethod"
```

### 6. 其他常用命令

#### 生成项目报告

生成项目的 HTML 报告（包括依赖树、任务等）：

```bash
    ./gradlew htmlDependencyReport
```

#### 查看可用任务

列出所有可用的 Gradle 任务：

```bash
    ./gradlew tasks
```

#### 查看项目属性

列出项目的所有属性：

```bash
    ./gradlew properties
```

### 7. 常用插件

#### `gradle-versions-plugin`

用于检查依赖更新。在 build.gradle 中添加以下配置：

```groovy
    plugins {
    id 'com.github.ben-manes.versions' version '0.53.0'
}
```

运行以下命令检查依赖更新：

```bash
    ./gradlew dependencyUpdates
```

#### `project-report`

用于生成项目报告。在 build.gradle 中添加以下配置：

```groovy
    plugins {
    id 'project-report'
}
```

运行以下命令生成报告：

```bash
    ./gradlew htmlDependencyReport
```

### 8. 常见问题

#### 构建失败

如果构建失败，可以运行以下命令查看详细日志：

```bash
    ./gradlew build --stacktrace
```

#### 依赖冲突

如果依赖冲突，可以运行以下命令查看依赖树并排查问题：

```bash
    ./gradlew dependencies
```

### 9. 参考文档

[Gradle 官方文档](https://docs.gradle.org/current/userguide/userguide.html)

[gradle-versions-plugin 插件文档](https://github.com/ben-manes/gradle-versions-plugin)