如何发布含非公开依赖的项目？以Oracle JDBC驱动为例

这确实是Oracle JDBC驱动绕不开的痛点——因为它默认不在Maven Central公开仓库，其他用户克隆你的项目后肯定会碰到依赖拉取不到的问题。给你几个靠谱的解决办法，按实用性优先级排序：

1. 配置Oracle官方Maven仓库（推荐） #

Oracle现在已经提供了公开的Maven仓库，你可以让项目直接从这里拉取依赖，不用再手动安装到本地仓库。做法是在项目的pom.xml里添加Oracle的仓库配置，同时保留原有的依赖声明：

首先在pom.xml的repositories节点下添加仓库配置：

<repositories>
    <repository>
        <id>maven.oracle.com</id>
        <url>https://maven.oracle.com</url>
        <layout>default</layout>
        <releases>
            <enabled>true</enabled>
        </releases>
    </repository>
</repositories>

如果遇到权限问题，让用户去Oracle官网注册一个免费账号，然后在Maven的settings.xml里添加认证信息：

<servers>
    <server>
        <id>maven.oracle.com</id>
        <username>你的Oracle账号邮箱</username>
        <password>你的Oracle账号密码</password>
    </server>
</servers>

这样其他用户只要配置好自己的Oracle账号，就能直接拉取依赖了。

2. 将驱动包纳入项目源码管理（适合小团队或无需账号的场景） #

把ojdbc8.jar放到项目的本地目录，比如src/main/resources/lib，然后在pom.xml里配置依赖的本地路径，同时用Maven插件确保它被正确打包到产物中：

首先添加依赖声明：

<dependency>
    <groupId>com.oracle</groupId>
    <artifactId>ojdbc8</artifactId>
    <version>12.2.0.1</version>
    <scope>system</scope>
    <systemPath>${project.basedir}/src/main/resources/lib/ojdbc8.jar</systemPath>
</dependency>

然后添加maven-dependency-plugin，确保这个jar包被复制到最终构建产物（比如war包的WEB-INF/lib目录）：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-dependency-plugin</artifactId>
            <executions>
                <execution>
                    <id>copy-system-dependencies</id>
                    <phase>package</phase>
                    <goals>
                        <goal>copy</goal>
                    </goals>
                    <configuration>
                        <artifactItems>
                            <artifactItem>
                                <groupId>com.oracle</groupId>
                                <artifactId>ojdbc8</artifactId>
                                <version>12.2.0.1</version>
                                <type>jar</type>
                                <outputDirectory>${project.build.directory}/${project.build.finalName}/WEB-INF/lib</outputDirectory>
                            </artifactItem>
                        </artifactItems>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

用户克隆项目后，不需要额外操作就能正常构建。注意：Oracle JDBC驱动有版权限制，务必确认你有权将它纳入项目源码管理后再这么做。

3. 提供自动安装脚本 #

写一个简单的脚本，把你手动执行的install:install-file命令封装进去，放在项目根目录。用户克隆后只需运行脚本，就能自动把驱动安装到本地Maven仓库。

Windows脚本（install-ojdbc.bat）：

mvn install:install-file -Dfile=src/main/resources/lib/ojdbc8.jar -DgroupId=com.oracle -DartifactId=ojdbc8 -Dversion=12.2.0.1 -Dpackaging=jar

Linux/macOS脚本（install-ojdbc.sh）：

#!/bin/bash
mvn install:install-file -Dfile=src/main/resources/lib/ojdbc8.jar -DgroupId=com.oracle -DartifactId=ojdbc8 -Dversion=12.2.0.1 -Dpackaging=jar

记得在项目的README.md里说明：“克隆项目后，请先运行install-ojdbc.bat（Windows）或./install-ojdbc.sh（Linux/macOS）来安装Oracle JDBC驱动”。

4. 使用Maven Central上的官方合规包（谨慎验证版本） #

Oracle后来将部分驱动版本上传到了Maven Central，你可以尝试替换依赖的groupId为官方新标识：

<dependency>
    <groupId>com.oracle.database.jdbc</groupId>
    <artifactId>ojdbc8</artifactId>
    <version>12.2.0.1</version>
</dependency>

不过要注意，不是所有旧版本都能在Maven Central找到，建议先验证版本的可用性后再使用这个方案。

内容的提问来源于stack exchange，提问作者Johnny Bravo